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PREFACE 


OVERALL PDP-15 DOCUMENTATION STRUCTURE 

A free-"type block diagram of the overall 'TOP-15 Family of Manuals" is illustrated 
on pageviii. A brief description of the contents and the order number of each manual 
shown in the diagram are presented on page ix. 


ORGANIZATION OF PDP-15 SOFTWARE MANUALS 
There are two basic catagories of PDP-15 software manuals: 


a. Unique, single-system, manuals which contain information concerning 
only one of the four available PDP-15 systems. This category consists of 
detailed software system descriptive manuals, each with an associated op¬ 
erational command summary. An example of this class of manual would be 
the "PDP-15/10 Software System" manual and its associated "PDP-15/10 
Users' Guide". 

b. Common, multi-system, manuals that describe utility, language, appli¬ 
cation and other PDP-15 programs which may be employed in one or more of 
the four available PDP-15 systems. Some examples of this type of manual are 
the PDP-15 "Utility", "MACRO-15 Assembler" and "STATPAC" manuals. 
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CHAPTER 1 
INTRODUCTION 


1.1 MACRO-15 LANGUAGE 

MACRO-15 is a basic PDP-15 symbolic assembler language which makes machine language programming on fhe 
POP-15 easier, faster and more efficient. It permits the programmer to use mnemonic symbols to represent in¬ 
struction operation codes, locations, and numeric quantities. By using symbols to identify instructions and data 
in his program, the programmer can easily refer to any point in his program, without knowing actual machine 

locations. 

Assembled MACRO-15 programs may be run on any PDP-15 system; however, MACRO-15 symbolic programs can 
be assembled only on systems which have at least 8K of memory and a monitor-type software system . 

The standard output of the Assembler is a relocatable binary object program that can be loaded for debugging or 
execution by the Linking Loader. MACRO-15 prepares the object program for relocation, and the Linking 
Loader sets up linkages to external subroutines. Optionally, the binary program may be output either with ab¬ 
solute addresses (non-relocatable) or in the full binary mode (see Chapter 3 for a description of the binary out- 
put modes). 

The programmer directs MACRO-15 processing by using a powerful set of pseudo-operation (pseudo-op) instruc¬ 
tions. These pseudo-ops are used to set the radix for numerical interpretation by the Assembler, to reserve 
blocks of storage locations, to repeat object code, to handle strings of text characters in 7-bit ASCII code or a 
special 6-bit code, to assemble certain coding elements if specific conditions are met, and to perform other 
functions which are explained in detail in Chapter 3. 

The most advanced features of MACRO-15 is its powerful macro instruction generator. This generator permits 
easy handling of recursive instruction sequences, changing only the arguments. Programmers can use macro in¬ 
structions to create new language elements, adapting the Assembler to their specific programming applications. 
Macro instructions may be called up to three levels, nested to £ levels, and redefined within the program. The 
technique of defining and calling macro instructions is discussed in Chapter 4. 

*A device-dependent version of MACRO-15, called MACROI-15, is available for use with 8K DECtape 
systems. Refer to Appendix G, 
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Art output listing, showing both the programmer's source coding and the object program produced by MACRO-15 
Is printed if desired. This listing may include all the symbols used by the programmer with their assigned values 
If assembly errors are detected, erroneous lines are marked with specific letter error codes, which may he inter¬ 
preted by referring to the error list in Chapter 5 of this manual. 

Operating procedures for MACRO assembly are described in detail in Chapter 5. (Refer to Appendix G for 
MACRO! Operating Procedures.) These procedures are also summarized in the "Users' Guide" for each Monitor 
Software system. 

1.2 HARDWARE REQUIREMENTS AND OPTIONS 

The MACRO-15 assembler program may be run on any of the following PD P-15 systems: 

a. 15/10 system which has a minimum of 8K of core and optional high-speed paper tape reader and 
punch units. 

b. basic 15/20 system 

c. basic 15/30 system 

d. basic 15/40 system 

1.3 ASSEMBLER PROCESSING 

The MACRO-15 assembler processes source programs in either a two-pass or three-pass operation. In the two- 
pass assembly operation the source program is read twice with the object program (and printed listing when re¬ 
quested) being produced during the second pass. During the first pass (PASS 1), the locations to be assigned 
the program symbols are resolved and a symbol table is constructed by the assembler. The second pass (PASS 2) 

uses the information computed during PASS 1 to produce the final object program. 

In an optional three-pass assembly operation, PASS 2 will call in a third pass (PASS 3) portion of the assembler 
program. PASS 3, when called, performs a cross referencing operation during which a listing is produced which 
contains: (a) all user symbols, (b) where each symbol is defined, and (c) the number of each program line in 
which a symbol is referenced. On completion of its operation, PASS 3 calls the PASS 1 and PASS 2 portions of 
the assembler program back into core for further assembly operations. 

The standard object code produced by MACRO-15 is in a relocatable format which is acceptable to the PDP-15 
Linking Loader Utility program. Relocatable programs that are assembled separately and use identical global 
symbols* where applicable, can be combined by the Linking Loader into an executable object program. 
MACRO-15 reserves one additional word in a program for every external** symbol. This additional word is used 

as a pointer to the actual data word in another program. The Linking Loader sets up these pointers when the 
programs are loaded. 

^Symbols which are referenced in one program and defined in another* 

**Symbols which are referenced in the program currently being assembled but which are defined in another progrc 
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Some of the advantages of having programs in relocatable format are as follows: 



a. Reassembly of one program, which at object time was combined with other programs, does not 
necessitate a reassembly of the entire system. 

b. Library routines (in relocatable object code) can be requested from the system device or user library 
device. 

c. Only global symbol definitions must be unique in a group of programs that operate together. 






CHAPTER 2 

ASSEMBLY LANGUAGE ELEMENTS 


2.1 PROGRAM STATEMENTS 

A single statement may be written on a 72-character Teletype line. In which case the carriage-return line-feed 
sequence characters delimit the statement. Such a statement actually begins with a line-feed character and is 
terminated by a carriage-return character. Since these form-control characters are not printed, they are repre¬ 
sented as J (carriage return) and i (line feed). In the examples of statements in this manual, only the carriage 
return Is shown: 


STATEMENT ) 

Several statements may be written on a single line, separated by semicolons; however, only the last statement 
may have a comments field: 

STATEMENT; STATEMENT; STATEME NT J 

In this case, the statement line begins with a line-feed character and ends with a carriage-return character, but 
semicolons are used as internal statement delimiters. Thus, if a statement is followed by another statement on 
the same line, it ends with a semicolon. 

A statement may contain up to four fields that are separated by a space, spaces, or a tab character. These four 
fields are the label (or tag) field, the operation field, the address field, and the comments field. Because the 
space and tab characters are not printed, the space is represented by b_j , and the tab by H in this manual. 

Tabs are set 8 spaces apart on Teletype machines s and are used to line up the fields in columns in the source 
program listing „ 

This is the basic statement format: 

LABEL H OPERATION H ADDRESS H /COMMENTS ) 

where each field is delimited by a tab or space, and each statement is terminated by a semicolon or carriage- 
return . The comments field is preceded by a tab (or space) and a slash (/). 
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Note that a combination of a space and a tab will be interpreted by the MACRO-15 assembler as two field 
delimiters. 

Example: 


TAG H OP H ADR J 1 both are 
TAG l-i H OP H ADR J j incorrect 

These errors will not show on the listing because the space is hidden in the fab. 

A MACRO-15 statement may have an entry in each of the four fields, or three, or two, or only one field. The 
following forms are acceptable: 

TAG J 

TAG H OP J 

TAG H OP H ADDR J 

TAG H OP H ADDRsuj/s) / comments^) 

TAG H OP 1 ^ ( 3 )/ comments J 

TAG H H ADDR J 

TAG H H ADDR (s) / comments^ 

TAG H (s) / / comments 
H OPj 

Hop H addrJ 

OP H ADDR H (s) / comments J 
H OP H (s) / comments^ 

H H ADDRJ 

H H ADDR H (s) / comments J 
/comments J 

H (s) / comments J 

Note that when a label field is not used, its delimiting tab is written, except for lines containing only comments. 
When the operation field is not used, its delimiting tab is written if an address field follows, except in label 
only and comments only statements. 

A label (or fag) is a symbolic address created by the programmer to identify the statement. When a label is 
processed by the Assembler, it is said to be defined. A label can be defined only once. The operation code 
field may contain a machine mnemonic instruction code, a MACRO-15 pseudo-op code, a macro name, a num¬ 
ber, or a symbol. The address field may contain a symbol, number, or expression which is evaluated by the 
assembler to form the address portion of a machine instruction. In some pseudo-operations, and in macro 
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instructions, this field is used for other purposes, as will be explained in this manual. Comments are usually 
short explanatory notes which the programmer adds to a statement as an aid in analysis and debugging. Comments 
do not affect the object program or assembly processing. They are merely printed in the program listing. Com¬ 
ments must be preceded by a slash (/). The slash (/) may be the first character in a line or may be preceded by: 

a * Space ( u ) 
b. Tab ( -*j ) 
c . Semicolon (;) 




2.2 SYMBOLS 

The programmer creates symbols for use in statements, to represent addresses, operation codes and numeric values. 
A symbol contains one to six characters from the following set: 


The letters A through Z 
The digits 0 through 9 

Two special characters, period ( . ) and the percent sign (%). 


The first character of a symbol must be a letter, a period, or percent sign. A period may not be used alone as 
a symbol. The first character of a symbol must not be a digit. 

The following symbols are legal: 

MARK! ..1234 .A 

A% %50.99 .% 

P9.3 INPUT 


The following symbols are illegal: 

TAG:1 L@B1 : and @ are i I legal characters. 

5ABC First character may not be a digit. 


Only the first six characters of a symbol are meaningful to the Assembler, but the programmer may use more for 
his own information. If he writes, 


SYMBOL! 

5YMBOL2 

SYMBOL3 
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as the symbolic labels on three different statements in his program, the Assembler will recognize only SYMBOL 
and may type error flags on the lines containing SYMBOL!, SYMBOL2 and SYMBOL 3. To the Assembler they 
are duplicates of SYMBOL. 

2,2.1 Evaluation of Symbols and Globafs 

When the Assembler encounters a symbol during processing of a source language statement, it evaluates the sym¬ 
bol by reference to two tables: the user's symbol table and the permanent symbol table. The user's symbol table 
contains all symbols defined by the user. The user defines symbols by using them as labels, as variables, as 
macro names and globals, and by direct assignment statements. A label is defined when first used, and cannot 
be redefined. (When a label is defined by the user, it is given the current value of the location counter, as will 
be explained later in this chapter.) 

All permanently defined system symbols (excluding the index register symbol, X), including Monitor commands 
and all Assembler pseudo-instructions use a period (.) as their first character. (In some cases the may be 
used as the last character of a Monitor I/O symbol). The Assembler has, in its permanent symbol table, defi¬ 
nitions of the symbols for all of the PDP-15 memory reference instructions, operate instructions, the basic EAE 
instruction, and some input/output transfer instructions. (See Appendix B for a complete list of these instructions.) 

PDP-15 instruction mnemonic symbols may be used in the operation field of a statement without prior definition 
by the user. 

Example: 


H L AC LJ A J LAC is a symbol whose appearance in the operation 

field of a statement causes the Assembler to treat it 
as an op code rather than a symbolic address. It has 
a value of 200000^ which is taken from the operation 
code definition in the permanent symbol table. 

The user can use instruction mnemonics or the pseudo-instruction mnemonics code as symbol labels. For example, 
DZM H DZM^Y J 

where the label DZM is entered in the symbol table and is given the current value of the location counter, and 
the op code DZM is given the value 140000 from the permanent symbol table. The user must be careful, how¬ 
ever, in using these dual purpose (field dependent) symbols. Symbols in the operation field are interpreted as 

either instruction codes or pseudo-ops, not as symbolic labels, if they are in the permanent symbol table. 

Monitor command op-code symbols cannot be duplicated by the user. In the following example, several symbols 
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with values have been entered in the user's symbol table and the permanent symbol table. The sample coding 
shows how the Assembler uses these tables to form object program storage words. 


User Symbol Table 

Permanent Symbol Table 

Symbol 

Value 

Symbol 

Value 

TAGl 

100 

LAC 

200000 

TAG2 

200 

DAC 

040000 

DAC 

300 

JMP 

600000 



X 

010000 


If the following statements the following code is generated 

are written, by the Assembler 


TAG1 H DAC H TAG2 040200 

TAG2 H LAC H DAC 200300 

DAC H JMP H TAG 1 

DAC H TAG!,X 
H TAG1 

2.2.1.1 Special Symbols - The symbol X is used to denote index register usage. It is defined in the permanent 
symbol table as having the value of 10000. The symbol X cannot be redefined and can only be used in the ad- 
dress field. 

2.2. 1.2 Memory Referencing Instruction Format - The PDP-15 uses 12 bits for addressing, 1 bit to indicate 
index register usage, 1 bit to indicate indirect addressing, and 4 bits for the op code. 



600100 

050100 

000100 
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2.2.2 Variables 


A variable is a symbol that is defined in the symbol table by using it in an address field or operation field with 
the number sign (^). Symbols with the ^ may appear more than once in a program (see items 1, 3, 4, and 5 of 
example given below). A variable reserves a single storage word which may be referenced by using the symbol 
at other points in the program with or without the ^. If the variable duplicates a user-defined label, it is mul¬ 
tiply defined and is flagged as an error during assembly. 

Variables are assigned memory locations at the end of the program. The initial contents of variable locations 
are unspecified. 

Example: 


Sequence 

Location 

Counter 

Source Statements 

Generated 

Code 



H 

.LOC u 100 


1 

100 

H 

LAC fc_j TA # G1 

200105 

2 

101 

H 

DACTAG3 

040107 

3 

102 

H 

LAC t _ J .TAG2 # 

200106 

4 

103 

H 

DAC^ T*AG3,X 

050107 

5 

104 

H 

LAC ,_/TAG2 

200106 



H 

.END 



2.2.3 Setting Storage Locations to Zero 

Storage words can be set to zero as follows: 

aH oH 0; Ho; 

In this way, three words are set to zero starting at A. Storage words can also be set to zero by statements con¬ 
taining only labels 

A; B; C; D; E J 

2.2.4 Direct Assignment Statements 

The programmer may define a symbol directly in the symbol table by means of a direct assignment statement, 
written in the form: 

SYMBOLS 

or 

SYM1-SYM2 
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where n is any number or expression. There should be no spaces between the symbol and the equal sign, or 
between the equal sign and the assigned value, or symbol. MACRO™ 15 enters the symbol in the symbol table, 
along with the assigned value. Symbols entered in this way may be redefined. These are legal direct assignment 
statements: 


XX =28; A=1;B=2 ) 

A symbol can also be assigned a symbolic value; e.g., A-4, , or 

SET^ISZ^SWITCH 

In the above example, the symbol B is given the value 4, and when the symbol SET is detected during assembly 
the object code for the instruction ISZ^SWITCH will be generated . This type of direct assignment cannot be 
used in a relocatable program. Direct assignment statements do not generate storage words in the object program. 

In general, it is good programming practice to define symbols before using them in statements which generate 
storage words. The Assembler will interpret the following sequence without trouble. 


Z=5 
Y=Z 
XX =Y 

H LAC ^ XX^/SAME AS LAC 5 J 
A symbol may be defined after use. For example, 

LAC Yj 

This is called a forward reference, and is resolved properly In PASS 2. When first encountered in PASS 1, the 
LAC Y statement is incomplete because Y is not yet defined. Later in PASS 1, Y is given the value 1 . In 
PASS 2, the Assembler finds that Y = 1 in the symbol table, and forms the complete storage word. 

Since MACRO-15 basic assembly operations are performed in two passes, only one-step forward references are 
allowed. The following is illegal: 

LAC Y J 
Y=Z J 
Z=1 ) 


In the listing, during PASS 1, the line which contains Y - Z will be printed as a warning. 





2.2.5 Undefined Symbols 


If any symbols, except global symbols, remain undefined at the end of PASS 1 of assembly, they are automatically 
defined as the addresses of successive registers following the block reserved for variables at the end of the pro¬ 
gram. All statements that referenced the undefined symbol are flagged as undefined. One memory location is 
reserved for each undefined symbol with the initial contents of the reserved location being unspecified. 

Examples: 


Flag 

Location 

Counter 

Source Statements 

Generated 

Code 

Comments 



H .LOC^ lOOJ 



u 

100 

H LAC UNDEF1J 

200106 

Undefined Symbol 


101 

H LAC ^ TAG* J 

200104 



102 

H LAC ^ TAG* O 

200105 


u 

103 

H LAC UNDEF2 J 

200107 

Undefined Symbol 



H . ENDJ 




2.3 NUMBERS 

The initial radix (base) used in all number interpretation by the Assembler is octal (base 8). To allow the user 
to express decimal values and then restore to octal values, two radix-setting pseudo-ops (.OCT and .DEC) are 
provided. These pseudo-ops, described in Chapter 3, must be coded in the operation field of a statement. If 
any other information is written in the same statement, the Assembler treats the other information as a comment 

and flags It as a cjuesfionab le line. All numbers are decoded in the current radix until a new radix control 

pseudo-op is encountered. The programmer may change the radix at any point in the program. 

Examples: 


Flag 

Source Program 

Generated Value (Octal) 

Radix in Effect 


H LAC H 100 

200100 

8 ^ initial value is 


H 25 

000025 

8 J assumed to be octal 


H .DEC 

H LAC H 100 

200144 

’0 


H 275 

000423 

10 

Q 

H . OCT u -99 


Octal radix takes effect even 
though line is flagged 


H 76 

000076 

8 

N 

H 99 

000143 

The non-octal digit forces a 
decimal radix for this number only 
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2.3.1 Integer Values 


An integer is a string of digits, with or without a leading sign. Negative numbers are represented in two's 
complement form. The range of integers is as follows: 


Unsigned 

0 -262143 ]0 

18 

(777777 ) or 2 -1 
° 17 

Signed 

tO -131071 lQ 

(377777.) or 2 -1 
B 17’ 

(400000.) or -2 
o 


-0 -131072 10 


An octal integer* is a string of digits (0-7), signed or unsigned. If a non-octal digit (8 or 9) is encountered 
the string of digits will be assembled as if the decimal radix was in effect and it will be flagged as a possible 
error. 

Example: 


Flag 

Coded Value 

Generated Value (Octal) 

Comment 


.DEC 




3779 

007303 



.OCT 




-5 

777773 

Two's complement 


3347 

003347 


N 

3779 

007303 

Possible error, decimal 
assumed 


A decimal integer** is a string of digits (0-9), signed or unsigned. 
Examples: 



2.3.2 Expressions 

Expressions are strings of symbols and numbers separated by arithmetic or Boolean operators. Expressions repre- 
sent unsigned numeric values ranging from 0 to 2 18 -1. All arithmetic is performed in unsigned integer arithmetic 

♦Initiated by .OCT pseudo-op and is also the initial assumption if no radix control pseudo-op was encountered. 
♦‘Initiated by .DEC pseudo-op. 
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(two's complement), modulo 2 . Division by zero is regarded as division by one and results in the original 

dividend. Fractional remainders are ignored; this condition is not regarded as an error. The value of an ex¬ 
pression is calculated by substituting the numeric values for each element (symbol) of the expression and per¬ 
forming the specified operations. 

The following are the allowable operators to be used with expressions: 


Character 

Function 

Name 

Symbol 


Plus 

+ 

Addition (two's complement) 

Minus 

- 

Subtraction (convert to two's complement and add) 

Asterisk 

* 

Multiplication (unsigned) 

Slash 

/ 

Division (unsigned) 

Ampersand 

& 

Logical AND 

Exclamation point 

i 

Inclusive OR 

Back slash 

\ 

Exclusive OR ) Boolean 

Comma 

t 

Exclusive OR 1 


Operations are performed from left to right (i.e. , in the order in which they are encountered). For example, 
the assembly language statement A+B*C+D/E~F*G is equivalent to the following algebraic expression 
(((((A+B)*C)+D)/E)-F)*G. 

Examples: 

Assume the following symbol values: 


Symbol 

Value (Octal) 

Comments 

A 

OCX) 002 


B 

000010 


C 

000003 


D 

000005 


X 

010000 

Index Register Value 


The following expressions would be evaluated. 
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Expression 

Evaluation (Octal) 

Comments 

A+B-C,X 

010007 

Index Register Usage 

A/B+A*C 

000006 

(The remainder of A/8 is lost) 

B/A-2*A-1+X 

010003 

Index Register Usage 

A & B 

000000 


C+A&D 

000005 


B*D/A 

000024 


B*C/A*D 

000074 


A,X+D,X 

010007 

Index Register Usage Error 


In the last example the expression is evaluated as follows: 


Sequence of arithmetic 

a. A, X = 000002 XORed with 010000 = 010002 

b. A,X+D = 010002 + QQ0QQ5 = 010007 

c. A,X+D,X = 010007 XORed with 010000 = 000007 

Note that arithmetic produces 000007 yet the value given in the example is 010007. Regardless of how the in¬ 
dex register is used in the address field, the index register bit will always be turned on by the Assembler. In 
the sequence of address arithmetic above, the line would be flagged with an X because of the illegal use of the 
index register symbol (X). 

Using the symbol X to denote index register usage causes the following restrictions: 


a. 

X cannot appear in the TAG field 

X H LAC H A 

b. 

X cannot be used in a .DSA statement 

.DSA 

A,X 

c. 

X can be used only once in an expression 
(see 2.4.3) 

LAC 

a,x+d,x 


2.4 ADDRESS ASSIGNMENTS 

As source program statements are processed, the Assembler assigns consecutive memory locations to the storage 
words of the object program. This is done by reference to the location counter, which is initially set to zero 
and is incremented by one each time a storage word is formed in the object program. Some statements, such as 
machine instructions, cause only one storage word to be generated, incrementing the location counter by one. 
Other statements, such as those used to enter data or text, or to reserve blocks of storage words, cause the 
location counter to be incremented by the number of storage words generated. 
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2.4.1 Referencing the Location Counter 

The programmer may directly reference the location counter by using the symbol period ( . ) in the address field. 
He can write. 


which will cause the program to jump to the storage word whose address was previously assigned by the location 
counter. The location counter may be set to another value by using the . LOC pseudo-op, described in Chapt@r3, 

2.4.2 Indirect Addressing 

To specify an indirect address, which may be used in memory reference instructions, the programmer writes an 
asterisk immediately following the operation field symbol. This sets the defer bit (bit 4) of the storage word. 

If an asterisk suffixes either a non-memory reference instruction, or appears with a symbol in the address field, 
an error will result. 

Two examples of legal indirect addressing follow. 

H tad*H a 

H LAC*HB 

The following examples are illegal. 

CLA* Indirect addressing may not be specified 

LAW* 17/77 in non-memory reference instructions. 


2.4.3 Indexed Addressing 

To specify indexed addressing an X is used with an operator directly after the address. No spaces or tabs may 
appear before the operator. The Assembler will perform whatever operation is specified with the index register 
symbol, and then continue to evaluate the expression. At completion of the expression evaluation, if the index 
bit is not on and the location counter is pointing to page 0 of any bank, the line is flagged with a B for bank 
error. The standard code used to indicate indexing is: 


LAC A,X 



Example: 


Object 


Location 

Code 

. ABSP 



000000 

210000 A 

LAC H 

X 

/Same as LAC 0,X 

000001 

050005 B 

dac-H 

A,X+1,7-1 

/ 

000002 

210001 

LAC - 

B+X 

/000001 ©010000 



.LOC 

10000 

/SET to page 1 

010000 

210001 C 

LAC 

X,D 


010001 

210000 D 

LAC 

c,x 




.END 



expression evaluation where A - 000000, B - 

000001, < 

I = 010000, X = 

010000 



Location 

0 

1 


2 

10000 


10001 


Address Field 


Discussion 


X The value of X is added to 0. Absence of 

an operator always implies addition. 


A,X+1,7-1 


B+X 

X,D 


c,x 


000000 © 010000 = 010000 
010000 + 000001 = 010001 
0100010000007 = 010006 
010006 - 000001 =■ 010005 

0000010010000 = 010001 

0100000010001 = 000001 

The index bit has been turned off during 
expression evaluation. Because the lo¬ 
cation counter (10000) is pointing to 
Page 1, this line is not flagged, and the 
index register bit is turned on. 

0100000010000 = 000000 

Same as example at Location 10000. 


NOTE: © = exclusive OR 


2.4.4 Literals 

Symbolic data references in the operation and address fields may be replaced with direct representation of the 
data enclosed in parentheses*. This inserted data is called a literal. The Assembler sets up the address link, 
so one less statement is needed in the source program. The following examples show how literals may be used, 
and their equivalent statements. The information contained within the parentheses, whether a number, symbol, 
expression, or machine instruction, is assembled and assigned consecutive memory locations after the locations 
used by the program. The address of the generated word will appear in the statement that referenced the literal 


*The opening parenthesis [ (] is mandatory; the closing parenthesis [) 3 is optional 
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Duplicate literals, completely defined when scanned in the source program during PASS 1, are stored only once 
so that many uses of the same literal in a given program result in the allocation of only one memory location for 
that literal. 



Usage of Literal 


DD .(]) 


H LAC (TAG) 


H LAC (DAC H TAG) 


H LACj__, (JMP H .+2) 


Equivalent Statements 


H ADD u ONE 
ONE H 1 


H LAC u TAGAD 

tagadH TAG 


H LAC u INST 
INST H DAC H TAG 


HERE H LAC 
INST H JMP 




The following sample program illustrates how the Assembler handles literals. 


Location Counter 



Source Statement 


H ■ loc ^ 100 

TAGlH LAC ^ (100) 

H DAC,^ 100 
H LAC ^ (JMP ^..+5 
H lac U (TAG1) 

H LAC (JMP ^ TAG 1) 
H LAC l _,(JMP 1 _,TAG2) 
TAG2=TAG1 

H LAC ^ (JMP ^ 0) 
DAC H LAC (DAC H DAC) 
H .END 


Generated Literals 


Generofed Code 


200110 


040100 


200110 

200112 

200113 


200114 

200115 



600100 

600000 


040107 


2 - 

























2.5 STATEMENT FIELDS 


The following paragraphs provide a detailed explanation of statement fields, including how symbols and numbers 
may be used In each field. 

2.5.1 Label Field 

If the user wishes to assign a symbolic label to a statement in order to facilitate references to the storage word 
generated by the Assembler, he may do so by beginning the source statement with any desired symbol. The 
symbol must not duplicate a system or user defined macro symbol and must be terminated by a space or tab, or a 
statement terminating semicolon, or carriage-return/line-feed sequence. 

Examples: 


TAG1;TAG2;TAG3;TAG4 A new logical line starts after each 

semicolon. This line is equivalent to 

tagH 0 ) 

TAG2H (U 
TAG3H Oj 
TAG4 H OJ 


If there was a tab or a space after the semicolon the symbol would be evaluated as an operator instead of a 
tag. The sequence 

TAG 1;TAG2;T AG 3; | __ | TAG4 

is evaluated as follows: 

TAG1 H Oj 

TAG2 J 
TAG3 H OJ 

TAG4 ) 

TAG u any value 

TAG (s) any value 

TAG H . . (s) any value 

TAG; 

TAGJ 

TAG (s) (no more data on line) 

When writing numbers separated by semicolons, the first number must be preceded by a tab ( H ) or a space („ „). 
The sequence 


These examples are equivalent to coding 
TAG H OJ 

in that a word of ail Os is output with 
the symbol TAG associated with it. 


TABLE 4 1 ;2;3;4;5 






produces TAG errors because the first symbol of a tag cannot be numeric. The correct way to write the table 
sequence is as follows: 

TABLE U j1; ! _ i 2; i _ j 3; lj 4; i _ i 5 

Symbols used as labels are defined in the symbol table with a numerical value equal to the present value of the 
location counter. A label is defined only once. If it was previously defined by the user, the current definition 
of the symbol will be flagged in error as a multiple definition. All references to a multiply defined symbol will 
be converted to the first value encountered by the Assembler. 


Example: 


Flag 

Location 

Counter 

Statement 

Storage Word 
Generated 

Notes 

M 

100 

BBB 

200103 


M 

101 

BESS 


Error, multiple definition 

D 

102 

■EBB 

200100 j 

First value of A referenced 


103 

bbhi 

000000 



104 

BE^B 

000000 



Anything more than a single symbol to the left of the label-field delimiter is an error; it will be flagged and 
ignored. The following statements are illegal. 

TAG+1 H LAS J 
LOC*2 H RAR J 

The line will be flagged with a "T M for tag error. The tag will be ignored but the rest of the line will continue 
to be processed. The only time that an error tag is not ignored is when the error occurs after the sixth character. 
The statement: 


TAGERROR*! u NOP 

will be assembled as: 

TAGERR H NOP 

and the line will be printed and flagged with a "T". 

Redefinition of certain symbols can be accomplished by using direct assignments; that is, the value of a symbol 
can be modified. If an Assembler permanent symbol or user symbol (which was defined by a direct assignment) 
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is redefined, the value of the symbol can be changed without causing an error message. If a user symbol, which 
was first defined as a label, is redefined by either a direct assignment or by using it again in the label field, it 
will cause an error. Variables also cannot be redefined by a direct assignment. 


Coding 

Generated Value (Octal) 

Comments 

A=3 


Sets current value of A to 3 

H LAC H A 

200003 


H DAC H A 

040003 


A=4 


Redefines value of A to 4 

H LAC H A 

200004 


B H DAC H A 

040004 

■k 

B=A 


Illegal usage; a label cannot 
be redefined 

H DAC -*\ B 

040105 


PSF=700201 


To redefine possibly incorrect 
permanent symbol definition. 


* Assume that this instruction will occupy location 105. 


2.5.2 Operation Field 

Whether or not a symbol label is associated with the statement, the operation field must be delimited on its left 
by a space(s) or tab. If it is not delimited on its left, it will be interpreted as the label field. The operation 
field may contain any symbol, number, or expression which will be evaluated as an 18“bit quantity using un- 

] Q 

signed arithmetic modulo 2 . In the operation field, machine instruction op codes and pseudo^op mnemonic 

symbols take precedence over identically named user defined symbols. The operation field must be terminated 
by one of the following characters: 


H or Lj 

J or ; 


(field delimiters) 
(statement delimiters) 


Examples: 


TAG H ISZ 

H - + 3 (s) 

^(s)CMAICMLJ 

H TAG/5+TAG2; -| TAG3J 

The asterisk (*) character appended to a memory reference instruction symbol, in the operation field, causes 
the defer bit (bit 4) of the instruction word to be set; that is, the reference will be an indirect reference. If 
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the asterisk (*) is appended on either a non “-memory reference instruction or any symbol in the address field, 
it will cause an error condition which will be flagged as a symbol error (S-f lag). The asterisk will be ignored 
and the assembly process will continue. 

Examples: 


Assembled Value 

Legal 

Assembled Value 

Illegal 

360001 

H tad*H a 

200001 

H LAC H A* 

220002 

H LAC* B 

750000 

Hcla* 


where A = 1 and B = 2 

However, the asterisk (*) may be used anywhere as a multiplication operator. 
Examples: 


Legal 

Illegal 

H LAC H TAG*5 

H TAG*TAG1 

H LAC H TAG*4+TAD* 

H A* 


2.5.3 Address Field 

The address field, if used in a statement, must be separated from the operation field by a tab, or space(s). The 

address field may contain any symbol, number, or expression which will be evaluated as an 18-bit quantify 

18 

using unsigned arithmetic, modulo 2 . If op code or pseudo-op code symbols are used in the address field, 

they must be user defined, otherwise they will be undefined by the Assembler and will cause an error message. 

The address field must be terminated by one of the following characters: 

or u (s) (field delimiters) 

J or ; (statement delimiters) 

Examples: 

TAG2 H DAC H .+3 

H H TAG2/5+3 (s) 

In the last example, the rest of the line will be automatically treated as a comment and ignored by the Assembler. 
The address field may also be terminated by a semocolon, or a carriage-return/line-feed sequence. 
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Examples: 


H jmpH BEGINS 
H TAD H A; H DAC H B H LAC 


In the last example f a tab or space(s) is required after the semicolon in order to have the Assembler interpret 
DAC as being the operation field rather than the label field. 

In the second line of the preceding example, the address field B is delimited by a tab. The LAC after the B H 
is ignored and is treated as a comment; but, the line is questionable because only a comment field occurs on a 
line after the address field. If the LAC had been preceded by a slash (/), the line would have been correct. 

When the address field is a relocatable expression, an error condition may occur. The size of the relocatable 
program is restricted to 4K-16 (4080^) words and cannot be loaded across pages or memory banks. Therefore, any 
relocatable address field whose value exceeds 7777 | s meaningless and will be flagged in error. This does not 
apply if the user specifies bank addressing (refer to description of . EBREL). 

When the address field is an absolute expression, an error condition will exist if the extended memory and page 
address bits (3, 4 and 5) do not match the corresponding bits of the address of the page currently being assembled 
into and these address bits are not 0 . 


NOTE 

In absolute mode, the page bits do not have to be equal 
if the .ABS or .FULL pseudo-ops are used instead of the 
.ABSPor .FULLP pseudo-ops. 


Examples: 


Location 

(octal) 


Comments 

30000 


1 



; Will not cause error messages 

30002 


J 

■ : 


Will cause a bank (B) error message 
because the address is on a different 

HI 


page. 


The linking loader will not relocate any absolute addresses; thus, absolute addresses within a relocatable program 
are relative to that page in memory in which the program is loaded. 












Example: 


Assume that the following source line is part of a relocatable program that was loaded into bank 1 
(20000 q -37777J. 

O Q 


Source Statement 

Effective Address 

H lac^sooj 

20300 


An exception to the above rule is the auto-mdex registers, which occupy location 10 
memory bank 0. The hardware will always ensure that indirect references to 10 o - 17, 


8 


will access 10 o - 17 0 of bank 0. 
a a 


8 


8 


- 17 in page 0 of 

Q 

in any page or bank 


2.5.4 Comments Field 

Comments may appear anywhere in a statement. They must begin with a slash (/) that is immediately preceded 
by 


a. 

*_j (s) 

space (s) 

b. 

H 

tab 

c. 

J 

carriage return/line feed (end of previous line) 

d. 

} 

semicolon 


Comments are terminated only by a carriage-return/lme-feed sequence or when 72^ 
encountered. 


characters have been 


Examples: 


i_. (s)AHIS IS A COMMENT (rest of line is blank) 

TAG! H LAC ^/after the ; is still a comment 
/THIS IS A COMMENT 
H RTR ^ /COMMENT J 
H RTR; H RTR; AHIS IS A COMMENT 

Observe that ; A/COMMENT^ is not a comment, but rather an operation field expression. A line that is 
completely blank; that is, between two sets of J i (s) is treated as a comment by the Assembler. 

Example: 


» . (72 blanks) 
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A statement is terminated as follows: 


Jl or ; or rest of line is completely blank. 

Examples: 

H LAC^ 

H DAC (the rest of the line is blank) 

H TAG+3 

H RTR; H RTR; H RTRj 

In the last example, the statement-terminating character, which is a semicolon (;) enables one source line to 
represent more than one word of object code. A tab or space is required after the semicolon in order to have 
the second and third RTRs interpreted as being in the operation field and not in the label field. 

2.6 STATEMENT EVALUATION 

When MACRO-15 evaluates a statement, it checks for symbols or numbers in each of the three evaluated fields: 
label, operation, and address. (Comment fields are not evaluated.) 

2.6.1 Numbers 

Numbers are not field dependent. When the Assembler encounters a number (or expression) in the operation or 
address fields (numbers are illegal in the label field), it uses those values to form the storage word. The follow¬ 
ing statements are equivalent: 

-*j 200000^10 J 
H 10 +LAC J 
H LAC ^10^ 

All three statements cause the Assembler to generate a storage word containing 200010. A statement may con¬ 
sist of a number or expression which generates a single 18-bit storage word; for example: 

H 23; 1 _ 1 45; l _ 1 357; i _ J 62 


This group of four statements generates four words interpreted under the current radix. 





2 .6.2 Word Evaluation 


When the Assembler encounters a symbol In a statement field, it determines the value of the symbol by reference 
to the user’s symbol table and the permanent symbol table, according to the priority list shown in paragraph 2.6.4 

The operation value is scanned for the following special cases: 


Mnemonic 

Operation Field Value 

LAW 

760000 

AAC 

723000 

AAS 

720000 

AXR 

737000 

AXS 

725000 


If the operation field is not one of the special cases, the object word value is computed as follows: 

(Operation Field + (Address Field and 17777)) = Word Value 

If the index register is used anywhere in the address field, the index register bit is set to one in the word value. 
Extensive error checking is then performed on the address field value. The following are the rules used to ensure 
correct results: 


a. If index register usage is specified, the result of XORing bit 5 of the location counter and bit 5 of 
the address field value must be non-zero. 


Example: 


Flag 

Location 

Object 

Value 

Tag 

Source Statement 

Page 

Addressing 





. ABSP 



00000 

210001 


LAC A,X 

/Page 0 


00001 

740000 

A 

NOP 



10000 



.LOC 10000 

/Page 1 

| 

10000 

210001 


LAC B,X 


B 

10001 

210001 

B 

LAC A,X 


_i 




..END 



The result of statement evaluation has produced the following results: 

A, X - 10001 A - 00001 

B, X = 00001 B - 10001 
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Note that when index register usage is specified, the index register bit may or may not be on. For B,X above, 
the index register bit was turned off during statement evaluations The Assembler turns this bit on when the word 
is evaluated, not at statement evaluation time* 

At location 10001, the result of XORing bit 5 of A,X and bit 5 of the location counter is 0. This signals the 
Assembler that the address reference (A) is in a different page. 

b. If index register usage is not specified and the program is not assembled in bank mode*, the result 
of XORing bit 5 of the location counter and the address field value must be 0, otherwise the line is 
flagged with a B for bank error. 

Example: 


Location 

Object 

Value 

Tag 

Source Stotem 

00000 

210500 


.ABSP 

LAC A 

10500 

10500 

740000 

A 

.LOG 10500 
NOP 




.END 


c B The bank bits (3,4) of the address field value in a relocatable program must never be on. The bank 
bits are always lost when the address field value and the operation are combined to form the object word 


Example: 


Location 


00000 R 
17777 R 
17777 R 
20000 R 


Object 

Value 

200000 R 

740000 A 
740000 A 


Source Statement 

LAC A /Bank bit lost 

.LOG C+l 7777 

NOP 

NOP 

.END 


d. If the bank bits of an absolute program are not zero, they must equal the bank bits of the location 



210001 

217777 


Source Statement 


. ABSP 

.LOG 20000 
LAC 1 
LAC 20001 
LAC 30001 
LAC 17777 
.END __ 


, .ABSP, .FULL, .FULLP, 


















The address value for Lines 3 and 4 are identical * The bank bits of Line 5 do not match those of the location 
counter, and indexed addressing was not specified, therefore, the line is flagged. 


2.6.3 Word Evaluation of the Special Cases 

a. LAW - The operation field value and the address field value are combined as follows: 

(Operation Value + (Address Field Value and 17777)) - Word Value 
A validity check is then performed on the address field value as follows: 

(Address Field Value and 760000) = Validity Bits 

If the validity bits are not equal to 760000 or 0, the line is flagged with an E to signal erroneous results. 

b. AAC, AAS, AXR, AXS - The operation field value and the address field value are combined as 
follows. 


(Operation Value + (Address Field Value and 000777)) = Word Value 


The validity check: 


(Address Field Value and 777000) = Validity Bits 


If the validity bits are not equal to 777000 or 0, the line is flagged with an E to signal erroneous 
results,, The address field value for this type of instruction cannot be relocated. The line is flagged 
with an R if the address field value is relocatable. 


Example: 


Line 

Flag 

Location 

Object 
Word Value 

. 

i 


0 

777777 

LAW 

17777 

/I7777 

2 


1 

777777 

LAW 

-1 

/777777 

3 

E 

2 

777777 


677777 

/6T7777 

4 


3 

760000 

A LAW 


/o 

5 


4 

720776 

AAS 

-2 

/77777b 

6 

E 

5 


AAS 


/776000 


If numbers are found in the operation and address fields, they are combined in the same manner as defined 
symbols. For example. 


H 2 H5 H/GENERATES 000007 
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The value of a symbol depends on whether it is in the label field, the operation field, or the address field. The 
Assembler attempts to evaluate each symbol by running down a priority list, depending on the field, as shown 
below. 

2.6.4 Assembler Priority List 


Label Field 

Operation Field 

Address Field 

Current Value of 

1. Pseudo-op 

1 . User symbol table (including 

Location Counter 

2. User macro in user symbol 

direct assignments) 


table 

3. System macro table 

4. Direct assignment in user 
symbol table 

5. Permanent symbol table 

6 . User symbol table 

7. Undefined 

2. Undefined 


This means that if a symbol is used in the address fields, it must be defined in the user's symbol table before the 
word is formed during PASS 2; otherwise, it is undefined. 

In the operation field, pseudo-ops take precedence and may not be redefined. Direct assignments allow the 
user to redefine machine op codes, as shown in the example below. 

Example: 


DAC = D POSIT 

System macros may be redefined as user macro names, but may not be redefined as user symbols by direct assign¬ 
ment or by use as statement labels. 

The user may use machine instruction codes and MACRO-15 pseudo-op codes in the label field and refer to them 
later in the address field. 







CHAPTER 3 
PSEUDO OPERATIONS 


In the discussion of symbols in the previous chapter, it was mentioned that the Assembler has in its permanent 
symbol table definitions of the symbols for all the PDP-15 memory reference instructions, operate instructions, 
the basic EAE instruction^ and many IOT instructions which may be used in the operation field without prior 
definition by the user. Also contained in the permanent symbol table are a class of symbols called pseudo¬ 
operations (pseudo-ops) which, instead of generating instructions or data, direct the Assembler on how to pro¬ 
ceed with the assembly • 

By convention, the first character of every pseudo-op symbol is a period ( . ). This convention is used in an 
attempt to prevent the programmer from inadvertently using, in the operation field, a pseudo-instruction symbol 
as one of his own. Pseudo-ops may be used only in the operation field. 

3.1 PROGRAM IDENTIFICATION (.TITLE) 

The program name may be written in a .TITLE statement as shown below. The Assembler will take the first six 
characters of the symbol in the address field as the new name of the program to appear in the header on the 
listing device. The listing device will be advanced to the top of form after which the line will be printed as 
a comment. The name will appear as the program name until the next .TITLE pseudo-op. The .TITLE pseudo-op 
has no effect on the binary or listing file name. 

.TITLE^NAME OF PROGRAM /(NAME) Name on listing 

delimited by space; 

H .TITLE H TEST1 /(TEST!) Name on listing 

3.2 OBJECT PROGRAM OUTPUT 

(.ABS, .ABSP, .FULL, .FULLP, .DBREL, .EBREL) 

The normal object code produced by MACRO-15 is relocatable binary which is loaded at run time by the Linking 
Loader. In addition to relocatable output, the user may specify two other types of output code to be generated 
by the Assembler. 
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a, The »ABS, ,ABSP, ,FULL, and ,FULLP pseudo-ops, specifying the type of output, must appear 
before any object code generating statements, otherwise the line will be flagged and ignored. Once 
one of these four pseudo- 2 ops is specified, the user is not allowed to change output modes, 

b. Any options provided for in the address field of the ,ABS and ,ABSP are useful only if the output 
device is paper tape. 


3.2.1 . ABSP, .ABS 


Label Field 

Operation Field 

Address Field 

Not used 

. ABSP 

NLD or 

Not used 

.ABS 

NLD or 



Both of the absolute pseudo-ops cause absolute, checksummed binary code to be output (no values are relocat¬ 
able). If no value is specified in the address field, the Assembler will precede the output with the Absolute 
Binary Loader which will load the punched output at object time. The loader is loaded, via hardware readin, 
into location 17720 of any memory bank. (This loader loads only paper tape.) If the address field contains 
NLD, no loader will precede the output. 


NOTE 

,ABSP output can be written on file-oriented devices. 

The Assembler assumes *ABSP NLD for all ,ABSP output 
to file-oriented devices and appends an extension of 
,ABS to the filename. This file can be punched with PIP, 
using dump mode. (There will be no absolute loader at 

the beginning of the tape.) 


A description of the absolute output format follows. 


Block Heading - (three binary words) 

WORD 1 Starting address to load the block body which follows. 

WORD 2 Number of words in the block body (two's complement). 

WORD 3 Checksum of block body (two's complement). Checksum 
includes Word 1 and Word 2 of the block heading. 

Block Body - (n binary words) 

The block body contains the binary data to be loaded under block heading control . 
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Starting Block - (two binary words) 

WORD 1 Location to start execution of program. It is distinguished from the 
block heading by having bit 0 set to 1 (negative). 

WORD 2 Dummy word. 

If the user requests the absolute loader and the value of the expression of the .END statement is equal to 0, the 
provided loader halts before transferring control to the object program, thereby allowing manual intervention by 
the user. 

The .ABSP pseudo-op causes all memory referencing instructions whose addresses are in a different page to be 
flagged as bank errors. A DBA instruction is executed by the absolute loader before control is given to the user 
program. Addresses which have bit 5 on will signal the processor to use the index register to compute effective 
addresses. 

The .ABS pseudo-op does not flag memory referencing instructions whose addresses are in a different page. An 
EBA instruction is executed, and control is given to the user in bank addressing mode* All indexing instructions 
(see Appendix B) are disabled and executed as I/O transfer instructions and complete bank addressing of 8K is 
allowed. The processor will interpret bit 5 of all memory referencing instructions as the high order address bit. 
A listing of the Absolute Binary Loader is given in Appendix F. 

3.2.2 .FULL, .FULL? Pseudo-ops 


Label Field 

Operation Field 

Address Field 

(Only useful 

Not used 

.FULL 

Not used 

if output 




is paper 

Not used 

.FULLP 

Not used 

tape) 


The .FULL and .FULLP pseudo-ops cause full binary mode output to be produced. The program is assembled as 
uncheckedsummed absolute code and each physical record of output contains nothing other fhan 18-bit binary 
storage words generated by the Assembler. The Assembler will cause the address of the .END statement to con¬ 
tain a punch in channel 7, thereby allowing the output to be loaded via hardware readin mode. If no address 
is specified in the .END statement, a halt (rather than a jump) will be output as the last word. 

The only difference between the .FULL and .FULLP pseudo-ops is that memory references across page boundaries 
are flagged in .FULLP mode; in .FULL mode they are not. 

In addition , memory references on Page 1 to addresses on Page 1 will have Bit 5 set to 0 unless indexing is 
specified. 


3-3 





The following specific restrictions apply to programs assembled in .FULL mode output. 

. LOC Should be used only at the beginning of the program. 

. BLOCK May be used only if no literals appear in the program, and 
must immediately precede .END. 

Variables and undefined symbols may be used if no literals appear in the 
program. 

Literals may be used only if the program has no variables and undefined 
symbols. 

The following two pseudo-ops enable relocation mode switching. They can be used anywhere and as often as 
the programmer wishes in a relocatable program. If these pseudo-ops are used in an absolute (.ABS, .ABSP, 
.FULL, .FULLP) program, they will be flagged (I-ignored). These pseudo-ops will be most useful for the user 
who has a VT15 display. The VT 15 has its own processor and uses 13-bit addresses. 

Mnemonic Description 

. EBREL Enable bank mode relocation 

Relocatable programs are normally in Page mode (12-bif re¬ 
location). This pseudo-op will cause a data word to be output 
to the Linking Loader having an octal code of 3]g. This octal 
code will signal the Linking Loader to treat all 03 loader codes 
as 13-bit relocatable. The data word will be Ignored by the 
Linking Loader. Addresses having 13-bits will not be flagged 
while in this mode. 

.DBREL Disable bank mode relocation 

A data word is output having a Linking Loader code of 32g. 

This code will signal the loader to treat all 03 codes as 12-bit 
relocation (normal PDP-15 mode); the data word will be ignored. 

NOTE 

The previous mode is not saved when an . EBREL is 
encountered; for this reason, a .DBREL pseudo-op 
goes directly to PDP-15 relocation regardless of 
previous mode. 


3.3 SETTING THE LOCATION COUNTER (.LOC) 

Label Field Operation Field Address Field 

Not used .LOC Predefined symbolic 

expression, or number 








The . LOC pseudo-op sets or resets the location counter to the value of the expression contained in the address 
field. The symbolic elements of the expression must have been defined previously; otherwise, phase errors might 
occur in PASS 2. The .LOC pseudo-op may be used anywhere and as many times as required. 

Examples: 


Location Counter 

Instruction 

100 

H .LOC^100 

100 

H LAC^TAG 1 

101 

H DAC 1 _ I TAG2 

102 

H • LOC. 

102 

aH lac^b 

103 

H DAC^C 

107 

H .LOC^A+5 

107 

H LAC^C 

110 

H DAC^D 

111 

H lac^e 

112 

Hdac^f 


3.4 RADIX CONTROL (.OCT and .DEC) 

The initial radix (base) used in all number interpretation by the Assembler is octal (base 8 ). In order to allow 
the user to express decimal values, and then restore to octal values, two radix setting pseudo-ops are provided. 



Meaning 

.OCT 

.DEC 

Interpret all succeeding numerical values in base 8 (octal) 

Interpret all succeeding numerical values in base 10 (decimal) 


These pseudo-instructions must be coded in the operation field of a statement. All numbers are decoded in the 
current radix until a new radix control pseudo-instruction is encountered. The programmer may change the 
radix at any point in a program. 


■B 

Source Program 

Generated Value (Octal) 

Radix in Effect 


—■ 

200100 

8 ^ initial value is 


H 25 

000025 

8 J assumed to be octal 


H .DEC 





200144 

10 
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Flag 

Source Program 

Generated Value (Octal) 

Radix in Effect 


H 275 

000423 

10 


H .OCT 




H 76 

000076 

8 

N 

H 85 

000125 

error 


3.5 RESERVING BLOCKS OF STORAGE (.BLOCK) 


.BLOCK reserves a block of memory equal to the value of the expression contained in the address field. If the 
address field contains a numerical value, it will be evaluated according to the radix in effect. The symbolic 
elements of the expression must have been defined previously; otherwise, phase errors might occur in PASS 2. 
The expression is evaluated modulo 2^ (77777^). The user may reference the first location in the block of 
reserved memory by defining a symbol in the label field. The initial contents of the reserved locations are 
unspecified. 


Label Field 

Operation Field 

Address Field 

User Symbol 

.BLOCK 

Predefined Expression 


Examples: 


BUFF H .BLOCK ^ 12 J 

H .BLOCK 1 _ I A+B+65j 


3.6 PROGRAM TERMINATION (.END) 

One pseudo-op must be included in every MACRO-15 source program. This is the .END statement, which must 
be the last statement in the main program. This statement marks the physical end of the source program, and also 
contains the location of the first instruction in the object program to be executed at run-time. 

The . END statement is written in the general form 

H ■ END^START J 

START may be a symbol, number, or expression whose value is the address of the first program instruction to be 
executed. In relocatable programs, to be loaded by the Linking Loader, only the main program requires a 
starting address; all other subprogram starting addresses will be ignored. 

A starting address must appear in absolute or self-loading programs; otherwise, the program will halt after being 
loaded and the user must manually start his program. 








These are legal .END statements 


H • END^JBEGIN+5 } 

H .END^200J 

3.7 PROGRAM SEGMENTS (.EOT) 

If the input source program is physically segmented, each segment except the last must terminate with an .EOT 
(end-of-tape) statement. The last segment must terminate with an .END statement. For example, if the input 
source program is prepared on three different tapes, the first two are terminated by .EOT statements, and the 
last by an .END statement. The .EOT statement is written without label and address fields, as follows. 

H . EOT J 

3.8 TEXT HANDLING (.ASCII and .SIXBT) 

The two text handling pseudo-ops enable the user to represent the 7-bit ASCII or 6-bit trimmed ASCII character 
sets. The Assembler converts the desired character set to its appropriate numerical equivalents. (See AppendixA.) 



Only the 64 printing characters (including space) may be used in the text pseudo-instructions. See nonprinting 
characters. Section 3.8.5, The numerical values generated by the text pseudo-ops are. left-justified in the 
storage word(s) they occupy with the unused portion (bits) of a word filled with zeros. 

3.8.1 .ASCII Pseudo-op 

.ASCII denotes 7-bit ASCII characters. (It is the character set that is the input to and output from Monitor.) 
The characters are packed five per two words of memory with the rightmost bit of every second word set to zero. 
An even number of words will always be output. 

Basic Form: 



3-7 






3.8.2 .SIXBT Pseudo-op 

. SIXBT denotes 6-bit trimmed ASCII characters, which are formed by truncating the leftmost bit of the 
corresponding 7-bit character. Characters are packed three per storage word. 


Basic Form: 


0 5 

6 11 

12 17 

1 st Char . 

2nd Char. 

3rd Char. 


3.8.3 Text Statement Format 

The statement format is the same for both of the text pseudo-ops. The format is as follows. 


MYTAG H | delimiter 


character string 


delimiter 


< expression >. 


3.8.4 Text Delimiter 

Spaces or tabs prior to the first text delimiter or angle bracket (<) will be ignored; afterwards, if they are not 
enclosed by delimiters or angle brackets, they will terminate the pseudo-instruction. Also, J will terminate 
the pseudo-instruction. 

Any printing character may be used as the text delimiter, except those listed below. 

a. < as it is used to indicate the start of an expression. 

b. ^ as It terminates the pseudo-instruction. 

(The apostrophe ( 1 ) is the recommended text delimiting character.) The text delimiter must be present on both 
the left-hand and the right-hand sides of the text string; otherwise, the user may get more characters than de¬ 
sired. However, J may be used to terminate the pseudo-instruction. 

3.8.5 Non-Printing Characters 

The octal codes for non-printing characters may be entered in .ASCII statements by enclosing them in angle 
bracket delimiters. In the following statement, five characters are stored in two storage words. 

H .ASCII ^‘AB 1 <015 > 1 CD 1 J 

Octal numbers enclosed in angle brackets will be truncated to 7 bits (.ASCII) or 6 bits (.SIXBT). 


3-8 




Example: 


Source Line 


Comments 

TAGH .ASCI 1 _j.'ABC' 

ABC 


H . SIXBT jj/ABC' 

ABC 


H .SIXBT l _ J 'ABC ,#, /< 1 

ABC'/ 

The ^ is used as a delimiter in order 
that ( 1 ) may be interpreted as text. 

H • ASCII u_,'ABCD'EFGE 

ABCDFG 


-«j .ASCII l _ J 'AB'<n> 

AB H 

<11> used to represent fab. 

H .ASCII I _ 1 'AB<11> 

AB< 11> 

There is no delimiter after B, 
therefore, (<11>) is treated as text. 

H .ASCII 1 5X012>'ABC 1 

ABC 


H .ASCII l _ 1 <15X12>ABC 1 _ 1 (s) 

^IBC^s) 

A is interpreted as the text delimiter. 
Also, since J was not used to ter¬ 
minate the text, the „ „(s) are inter¬ 
preted as text characters. 


The following example shows the binary 


word format which MACRO-15 generates for a given line of text. 


Example: 


H .ASCII H 'ABC'<015X12>'DEF 


Generated Coding 


Word Number 

Octal 


Bi 

nary 




Word I 

406050 

1000001 

10000010 

1000 

Word 2 

306424 

011 

0001101 

0001010 

0 

Word 3 

422130 

1000100 

1000101 

1000 

Word 4 

600000 

no 

0000000 

0000000 

0 


3.9 LOADER CONTROL (.GLOBL) 


Label Field 

Operation Field 

Address Field 

Not used 

.GLOBL 

A,B, C ,D ,E. ... 


The standard output of the Assembler is a relocatable object program. The Linking Loader joins relocatable 
programs by supplying definitions for global symbols which are referenced in one program and defined in another. 
The pseudo-op .GLOBL, followed by a list of symbols, is used to define to the Assembler those global symbols 
which are either 

a. internal globals - defined in the current program and referenced by other programs 

b. external symbols - referenced in the current program and defined in another program 
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The loader uses this information to load and then link the relocatable programs to each other. 

All references to external symbols should be indirect references as memory banks may have to be crossed. 


Examples; -| .GLOBL H A,B,C 

A H LAC HD /A is an internal global 

D JMS* -®| B /These two instructions reference 

H JMS* H C /External symbols indirectly 

.END 

The .GLOBL statement may appear anywhere within the program. 

Each external symbol causes an additional word to be reserved in the user program. This word will be used by 
the Linking Loader to store the actual address at load time. 

The example above is assembled as follows: 


Flag 

Location 

Word Value 


• GLOBL A 

,B,C 


000000 R 

200001 R 

A 

LAC 

D 


■ ■ 

120003 R 

D 

JMS* 

B | 



120004 R 


JMS* 

C 



000001 


.END 

D 


000003 R 

000003 *E 





000004 R 

j 000004 *E 





The values for locations 3 and 4 will be put in by the Linking Loader. 

3.10 REQUESTING I/O DEVICES (.IODEV) 

The .IODEV pseudo “Op appears anywhere in the program and is used to cause the Assembler to output code for 
the Linking Loader which specifies the slots in the Monitor's device assignment table (DAT) whose associated 
device handlers are required by the program (see the applicable Monitors manual listed on Page ix). 


Label Field 

Operation Field 

Address Field 

Not used 

.IODEV 

1,2,3... 


The arguments may be numeric or symbolic. If the argument is symbolic ? the symbol must be defined by a 
direct assignment statement. 

3.11 DEFINING A SYMBOLIC ADDRESS (.DSA) 

.DSA (define symbol address) is used in the operation field when it is desired to create a word composed of just 
an address field. It is especially useful when a user symbol is also an instruction or pseudo-op symbol. 


3-10 










'"■'S 


Label Field 

Operation Field 

Address Field 


.DSA 



Examples: 

JMP H LAC HtAG 
H .dsaH JMP 
H H jmp 

3.12 REPEATING OBJECT CODING (.REPT) 


Equivalent methods of defining the user symbol JMP 
to be in the address field. 


Label Field 

Operation Field 

Address Field 

Not used 

.REPT 




The .REPT pseudo-op causes the object code of the next sequential object code generating instruction to be 
repeated count times. Optionally, the object code may be incremented for each time it is repeated by speci¬ 
fying an increment. The count and increment may be represented by a numeric or symbolic value. If a symbol 
is used, it must be defined by an absolute direct assignment statement which must occur before the symbol is 
used. The repeated instruction may contain a label, which will be associated with the first statement generated* 


Examples: 


Source Code 

Generated 

Object Code 

H .REPT^5 

■A o 

000000 


000000 


000000 


000000 


000000 

H ■REPT 6 _ j 4,1 

H i 

000001 


000002 


000003 


000004 

-| • REPT 1 __ I 3, —I 
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Source Code 

Generated 
Object Code 

H 5 

000005 


000004 


000003 

TAG=50 


H .REPT .4,1 

1 u 


H JMP TAG 

600050 


600051 


600052 


600)53 


NOTE 

If the statement to be repeated generates more than one 
location of code, the .REFT will repeat only the last lo- 
cation. For example, 

H .REPT^S 

H . ASCII ^'A 1 

will generate the following: 

404000 5/7 A 

000000 

0(X)000 last word is 
000000 repeated 

3.13 CONDITIONAL ASSEMBLY (.IF xxx and . ENDC) 

It is often useful to assemble some parts of the source program on an optional basis. This is done in MACRO-15 
by means of conditional assembly statements, of the form: 

“*| .IF... -*| expression 

The pseudo-op may be any of the eight conditional pseudo-ops shown below, and the address field may contain 
any number, symbol, or expression. If there is a symbol, or an expression containing symbolic elements, such 
a symbol must have been previously defined in the source program. 

If the condition is satisfied, that part of the source program starting with the statement immediately following 
the conditional statement and up to but not including an .ENDC (end conditional) pseudo-op is assembled. If 
the condition is not satisfied, this coding is not assembled. 

The eight conditional pseudo-ops (sometimes called IF statements) and their meanings are shown below. 
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Pseudo-op 

Assemble IF x is: 

H IFPNZ^x 

Positive and non-zero 

H .ifneg^x 

Negative 

H .IFZER^x 

Zero 

H .IFPOZ^x 

Positive or zero 

H .IFNOZ,_,x 

Negative or zero 

H .ifnzr^x 

Not zero 

H .IFDEF^x 

A defined symbol 

H .IFUND^x 

An undefined symbol 


In the following sequence, the pseudo-op .IFZER is satisfied, and the source program coding between .IFZER 
and .ENDC is assembled. 

SUBTOT=48 

TOTALL=48 

H .IFZER H SUBTOT-TOTALL 

-*\ lac^a 
Hdac^b 

H .ENDC 

Conditional statements may be nested. For each IF statement there must be a terminating .ENDC statement. 

If the outermost IF statement is not satisfied, the entire group is not assembled. If the first IF is satisfied, the 
following coding is assembled. If another IF is encountered, however, its condition is tested, and the following 
coding is assembled only if the second IF statement is satisfied. Logically, nested IF statements are like AND 
circuits. If the first, second, and third conditions are satisfied, then the coding that follows the third nested 
IF statement is assembled. 

Example: 

H .IFPOZ^X 
H LAC H TAG 
H .IFNZR^Y 
H DAC H TAG! 

H .ENDC 
H . IFDEF^j Z 
H DAC H TAG2 
H .ENDC 
H .ENDC 


conditional 1 initiator 

conditional 2 initiator 

conditional 2 terminator 
conditional 3 initiator 

conditional 3 terminator 
conditional 1 terminator 
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Conditional statements can be used in a variety of ways. One of the most useful is in terminating recursive 
macro calls (described in Chapter 4). In general, a counter is changed each time through the loop, or recursive 
call, until the condition is not satisfied. This process concludes assembly of the loop or recursive call. 


3.14 LISTING CONTROL (.EJECT) 

The following Assembler listing controls are effective only when a listing is requested by Assembler control key¬ 
board request. 


Label Field 

Operation Field 

Address Field 

Not used 

.EJECT 

Not used 


When .EJECT is encountered anywhere in the source program, it causes the listing device that is being used to 
skip to head-of-form . 

3.15 PROGRAM SIZE .(.SIZE) 


Label Field 

Operation Field 

Address Field 

User Symbol 

.SIZE 

Not used 


When the Assembler encounters .SIZE, it outputs, at that point, the address of the last location, plus one occu¬ 
pied by the object program. This is normally the length of the object program (in octal). 


3.16 DEFINING MACROS (.DEFIN, .ETC, and . ENDM) 

The .DEFIN pseudo-op is used to define macros (described in Chapter 4). The address field in the .DEFIN 
statement contains the macro name, followed by a list of dummy arguments. If the list of dummy arguments will 
not fit on the same line as the .DEFIN pseudo-op, it may be continued by means of the .ETC pseudo-op in the 
operation field and additional arguments in the address field of the next line. The coding that is to constitute 
the body of the macro follows the .DEFIN statement. The body of the macro definition is terminated by an 
.ENDM pseudo-op in the operation field. (See Chapter 4 for more details on the use of macros.) 


CHANGE 1 
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3.17 ASSEMBLY LISTING OUTPUT CONTROL (.NOLST & .LST) 


Label Field 

Operation Field 

Address Field 

Not used 

\ 

f. NOLST 1 
L. LST J 


Not used 


If, while performing an assembly listing operation (L, X, or N assembly parameters), the assembler encounters 
a .NOLST, the listing operation will be terminated until a .LST is found. These pseudo-ops are useful when 
the user wishes to assemble all of a program, but only needs a listing of certain modules of the program (e.g., 
those which may not yet work properly). All symbols occurring between .NOLST and .LST will appear in the 
cross reference and symbol table listings when requested (A, V, X, or S assembly parameters). 
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CHAPTER 4 
MACROS 





When a program is being written, it often happens that certain coding sequences are repeated several times with 
only the arguments changed. It would be convenient if the entire repeated sequence could be generated by a 
single statement. To accomplish this, it is first necessary to define the coding sequence with dummy arguments 
ds a macro instruction, and then use a single statement referring to the macro name along with a list of real 
arguments which will replace the dummy arguments and generate the desired sequence. 

Consider the following coding sequence. 

H LAC H A 
H TAD H B 

H dacH c 
lac H d 

H TAD H E 

H dacH f 

The sequence 

LAC H x 
H TAD H y 
H DAC H z 

is the model upon which the repeated sequence is based. The characters x, y, and z are called dummy arguments 
and are identified as such by being listed immediately after the macro name when the macro instruction is 
defined. 


4.1 DEFINING A MACRO 

Macros must be defined before they are used. The process of defining a macro is as follows. 
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(Macro^Name) (Dummy Arguments) 

(Definition Line) H .DEFIN H MACNME, ARGl ?ARG2t ARG3 -*j /comment 

r H LAC H ARGl 

(Body) / H TAD H ARG2,X 

L H DAC H ARG3 

(Terminating Line) H . ENDM 

The pseudo-op .DEFIN in the operation field defines the symbol following it as the name of the macro. Next, 
follow the dummy arguments, as required, separated by commas and terminated by any of the following symbols. 


a. 

space 

(t_j) 

b. 

tab 

( H ) 

c. 

carriage return 

(J) 


The macro name and the dummy arguments must be legal MACRO-15 symbols. Any previous definition of a 
dummy argument is ignored while in a macro definition. Comments after the dummy argument list in a definition 
are I ega I. 

If the list of dummy arguments cannot fit on a single line (that is, if the .DEFIN statement requires more than 
72 ^q characters) it may be continued on the succeeding Sine or lines by the usage of the .ETC pseudo-op, as 
shown below. 


H DEFIN H MACNME,ARG1,ARG2, ARG3 /comment 
H . ETC HARG4, ARG5 /argument continuation 

H .definH macnme 

H .ETC H ARGl 
H .ETC H ARG2 
H .ETC -*! ARG3 
H .ETC H ARG4 
H .ETC H ARG5 

4.2 MACRO BODY 

The body of the macro definition follows the .DEFIN statement. Appearances of dummy arguments are marked 
and the character string of the body is stored, five characters per two words in the macro definition table, until 
the macro terminating pseudo-op .ENDM is encountered. Comments within the macro definition are not stored. 

Dummy arguments may appear in the definition lines only as symbols or elements of an expression. They may 
appear in the label field, operation field, or address field. Dummy arguments may appear within a literal or 
they may be defined as variables. They will not be recognized if they appear within a comment. 
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The following restrictions apply to the usage of the .DEFIN, .ETC and . ENDM pseudo-ops: 

a. If they appear in other than the operation field within the body of a macro definition, they will 
cause erroneous results. 

b. If .ENDM or .ETC appears outside the range of a macro definition, it will be flagged as undefined. 

If index register usage is desirable, it should be specified in the body of the definition, not in the argument 
string. 


.DEFIN XUSE,A,B,C 

LAC A 

DAC B,X 

LAC C 

.ENDM 

If .ASCII or . SIXBT is used in the body of a macro, a slash (/) or number sign ( # ) must not appear as part of 
the text string or as a delimiter (use <57> to represent a slash and <43> to represent a number sign). A dummy 
argument name should not inadvertently be used as part of the text string. 

Definition Comments 

H .DEFIN H MAC,A,B,C,D,E,F 
H LAC H A# 

H SPA 

H jmpH B 

H ISZ HTMP H /E E is not recognized as an argument 

H LAC H (C 
H DACH D + 1 
H F 

H .ASCII-| E 
B-. 

H .ENDM 

4.3 MACRO CALLS 

A macro call consists of the macro name, which must be in the operation field, followed by a list of real argu¬ 
ments separated by commas and terminated by one of the characters listed below. 


a. 

space 

<-> 

b. 

tab 

H ) 

c. 

carriage return 

(J) 
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If the real arguments cannot fit on one line of coding, they may be continued on succeeding lines by terminating 
the current line with a dollar sign ( $). When they are continued on succeeding lines they must start in the tag 
field. 

Example: 


H MACH REALl ,REAL2,REAL3,$ 

REAL4,REAL5 

If there are n dummy arguments in the macro definition, all real arguments in the macro call beyond the nth 
dummy argument will be ignored. A macro call may have a label associated with it; this label will be assigned 
to the current value of the location counter. 


Example: 


(Definition) H .DEFIN H UPDATE,LOC,AMOUNT 
H LAC H LOC 
H TAD H AMOUNT 
H DACH LOC 
H . ENDM 


(Call TAGH UPDATE H CNTR,(5 

(Expansion) TAGH LAC -®j CNTR 
H TAD H (5 
H DAC H CNTR 


/TAG ENTERED INTO SYMBOL TABLE 

/With current value of location counter 


The prevailing radix will be saved prior to expansion and restored after expansion takes place. Default as¬ 
sumption will be octal for the macro call. It is not necessary for the macro definition to have any dummy argu- 
ments associated with it. 


Example: 


H .DEFIN^TWOS 
H CMA 

H tad^o 

H .ENDM 

(Call) H TWOS 

(Expansion) H CMA 

H TADH (1 


4-4 




4 e 3. 1 Argument Delimiters 

It wos stated that the list of arguments is terminated by anv of the foliowing symbo's. 


space 

(a —b ) 

tab 

( H ) 

carriage return 

(J) 


These characters may be used within real arguments only by enclosing them in angle brackets. Angle brackets 
will not be recognized if they appear within a comment. 


Example: 


(Definition) 

H .DEFIN,_jMAC,A,B,C 

H LAC^A 

H TAD^B 

H DAC^C 

H .ENDM 

(Call) 

-*j MACjjTAGI ,<TAG2 /comment 
H TAD l _ 1 (l)>,TAG3 

(Expansion) 

H LAC^TAGl 

H TAD l _ J TAG2 

H TAD l _ J (I) 

H DAC^TAGS 


All characters within a matching pair of angle brackets are considered to be one argument, and the entire argu¬ 
ment, with the delimiters (<>) removed, will be substituted for the dummy argument in the original definition. 

MACRO-15 recognizes the end of an argument only on seeing a terminating character not enclosed within angle 
brackets. 

If brackets appear within brackets, only the outermost pair is deleted. If angle brackets are required within a 
real argument, they must be enclosed by argument delimiter angle brackets. 

Example: 

(Definition) -f .DEFIN H ERRMSG,TEXT 
H JMS H PRINT 
H .ASCII H TEXT 
-I . ENDM 





(Call) H ERRMSGH </ERROR IN LINE/ <15» 

(Expansion) H JMS H PRINT 

H .ASCII H /ERROR IN LINE,/ < 15> 


4.3.2 Created Symbols 

Often, It is desirable to attach a symbolic tag to a line of code within a macro definition. As this tag is de~ 
fined each time the macro is called, a different symbol must be supplied at each call to avoid multiply defined 
tags. 

This symbol can be explicitly supplied by the user or the user can implicitly request MACRO-15 to replace the 
dummy argument with a created symbol which will be unique for each call of the macro. For example, 

H .DEFIN H MAC,A, ?B 

The question mark (?) prefixed to the dummy argument B indicates that it will be supplied from a created symbol 
if not explicitly supplied by the user when the macro is called for. 

The created symbols are of the form . .OOOCK .9999. Like other symbols, they are entered into the symbol table 
as they are required. 


Unsupplied real arguments corresponding to dummy arguments not preceded by a question mark are substituted in 
as empty strings; and supplied real arguments corresponding to dummy arguments preceded by a question mark 
suppress the generation of a corresponding created symbol . 


Example: 

(Definition) H .DEFIN H MAC, A,B, ?C, ?D , ?E 
H LAC H A 
H SZA 
H JMP H D 
H LAC H B 
H DAC H c # 

H dacH e 

D=. 

H .endm 

(Call) MACH x#,,,,mytag 

(Expansion) H LAC H X # 

H SZA 
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H jmp H -oooo 

H LAC 

H DAC H ..0001 
H DAC H MYTAG 
.. 0000 =. 

If one of the elements in a real argument string is not supplied, that element must be replaced by a comma, as 
In the call above. A real argument string may be terminated in several ways as shown below: 

Example: 

H MAC H A,B, u 
-®j MAC -®j A, B,, ^ 

H macH a,b^, 

H MAC H A,B J 
H MAC H A,B,J 

4.4 NESTING OF MACROS 

Macros may be nested; that is, macros may be defined within other macros. For ease of discussion, levels may 
be assigned to these nested macros. The outermost macros (those defined directly) will be called first-level 
macros. Macros defined within first-level macros will be called second-level macros; macros defined within 
second-level macros will be called third-level macros, etc. Each nested macro requires an . ENDM pseudo op 
to denote its termination. 

Example: 


Level 1 


H .DEFIN H LEVEL1,A,B 

H LAC H A 

-*| TAD H B Level 2 


H .DEFIN H LEVEL2,C,D 

H iszH C 

H DAC H D Level 3 

1 


H .DEFIN H LEVEL3,E,F 

H andH E 

H xorH f 

H .ENDM i 

1 

1 

LEVEL 3 .ENDM 

H dacH x 

H .ENDM ^ 

1 

LEVEL 2 .ENDM 


; dacH y 

1 .ENDM \ 

r LEVEL 1 .ENDM 
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At the beginning of processing, first-level macros are defined and may be called in the normal manner. Second 
and higher level macros are not yet defined. When a first-level macro is called, all its second-level macros 
are defined. Thereafter, the level of definition is irrelevant and macros may be called in the normal manner. 

If the second-level macros contain third-level macros, the third-level macros are not defined until the second- 
level macros containing them have been called. 

Using the example above, the following would occur: 


Call 

Expansion 

Comments 

H LEVEL 1 H TAG!, TAG2 

H LAC H TAGl 

Causes LEVEL 2 


H TAD H TAG2 

to be defined 


H dacH y 


H LEVEL 2 H TAG3, TAG4 

H ISZ HTAG3 

Causes LEVEL 3 


H DAC H TAG4 

H DAC H X 

to be defined 

H LEVEL 3 H TAG5, TAG6 

H ANDH TAG5 

H XORH TAG6 



If LEVEL 3 is called before LEVEL 2 it would be an error, and the line would be flagged as undefined. 

When a macro of level n contains another macro of the level n + ], calling the level n macro results in the 
generation of the body of the macro into the user's program in the normal manner until the .DEFIN statement 
of the level n 1 macro is encountered; the level n + 1 macro is then defined and does not appear in the user's 
program. When the definition of the level n + 1 is completed (.ENDM encountered), the Assembler continues 
to generate the level n body into the user's program until, or unless, the entire level n macro has been generated. 


4.5 REDEFINITION OF MACROS 

If a macro name, which has been previously defined, appears within another definition, the macro is redefined 
and the original definition is eliminated. For example. 


H .DEFIN H INDXSV 
H jmsH SAVE 
H JMP H SAVXT 

saveH 0 

H LAC H 10 
H dacH tmp* 

H LAC H 11 
H DAC H TMP1* 


H JMP* H SAVE 
SAVXT=. 

H .definH indxsv 
H jmsH save 

H . ENDM 
H .ENDM 


When the macro INDXSV is called for the first time, the subroutine calling sequence is generated and followed 
immediately by the subroutine itself. After the subroutine is generated, a .DEFIN that contains the name 
INDXSV is encountered. This new macro is defined and takes the place of the original macro INDXSV. All 
subsequent calls to INDXSV cause only the calling sequence to be generated. The original definition of INDXSV 
will not be removed until after the expansion is complete. 


Call 

H INDXSV 


H INDXSV 


Expansion 

H JMS H SAVE 
H JMP H SAVXT 

saveH 0 

H LAC H 10 
H DAC H TMP# 
H LAC H 11 
H DAC H TMP1 # 

H jmp*H save 

SAVXT=. 

HJMS HSAVE 


4.6 MACRO CALLS WITHIN MACRO DEFINITIONS 

The body of a macro definition may contain calls for other macros which have not yet been defined. However, 
the embedded calls must be defined before a call is issued to the macro which contains the embedded call. 
Embedded calls are allowed only to three levels. 

Example: 


H .DEFIN H MAC1 ,A,B,C,D,E 
H LAC H A 

H tadH b 

H MAC2 H C,D 
H DAC H E 


/EMBEDDED CALL 
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/DEFINITION OF EMBEDDED CALL 


H . ENDM 

H .DEFIN H MAC2,A,B 
H XOR H A 
H AND B 
H .ENDM 

The call 

H MACl H TAG 1 ,TAG2, (400, (777, TAG3 
causes generation of 

-*| LAC H TAG1 
H TAD H TAG2 
H MAC2 H (400, (777 
H XOR H (400 
H ANDH (777 
H DAC H TAG3 

4.7 RECURSIVE CALLS 

Although it is legal for a macro definition to contain an embedded call to itself, it must be avoided because 
the expansion will cause more than three levels to occur. 


Example: 


H .DEFIN -lMAC,A,B,C 
H LAC H A 
H TAD H B 
H DAC H c 

H MAC H A,B,C /RECURSIVE CALL 

H .ENDM 

When a call for MAC is encountered by the Assembler, it searches memory for the definition and expands it. 
Since there is another call for MAC contained within the definition, the Assembler goes back once again to 
obtain the definition; this process would never cease, if more than three levels were allowed. A conditional 
assembly statement could be used, however, to limit the number of levels as in the following example. 

Example: 


A = 0 
B = 3 

H .DEFIN H MAC,C,D 
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/RECURSIVE CALL 


H LAC H C 
H DACH D 
A= A + 1 

H JFNZR H B-A 
H MAC H SAVE,TEMP 
H .ENDC 
H .ENDM 


Names and arguments of nested macros and arguments of imbedded cal Is may be substituted and used with perfect 
generality. 

Example: 

H .definH maci,a,b,c,d 

H LACH A 

H addH b 
H DAC H c 
H .DEFIN H D,E 
H A ND H A 
H DAC H E 
H .ENDM 
H .ENDM 

H .DEFIN H MAC2,M,N,0,P,Q,?R 
ISZH M 

H jmpH r 

H MAC! H N,0,P,Q 
R=. 

H .ENDM 

The cal I 

H MAC2 H COUNT,TAG I, TAG2,TAG3,MAC3 

causes the generation of 

H 1SZ H COUNT 

H JMP -*J ..0000 

H LAC H TAG1 

H ADD H TAG2 

H DAC H TAG3 
.. 0000 =. 

It also causes the definition of MAC3 
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CHAPTER 5 
OPERATING PROCEDURES 


5.1 INTRODUCTION 

Detailed descriptions of the assembler calling procedure, command string format, general operating procedures, 
and printouts are given in this chapter. (Refer to Appendix G for MACRO I operating procedures.) 

5.2 CALLING PROCEDURE 

The MACRO-15 Assembler is called by typing MACRO J after the Monitor's $ request. When the Assembler 
has been loaded, it identifies itself by typing: 

MACRO-15 VNN J 

on the Teletype and waiting for command string lines from the user. 


5.3 GENERAL COMMAND CHARACTERS 

The following characters are frequently used in the entry and control of MACRO programs. 

Character Printout 

RUBOUT (Echoes \) delete single character 
CTRL U (Echoes @) delete current line 

CTRL F (Echoes tP) a. If the input file is segmented into separate units ending with a .EOT, ready the 
input device with the next segment and type CTRL P, 

b. If paper tape input or segmented input is to be used, ready the input device with 
the next pass and type CTRL P. 

c. If the Assembler is not waiting for more input, or is not waiting to start the next 
pass, typing CTRL P causes the Assembler to restart at PASS 1. 

CTRL D (Echoes tD) If the user specifies the Teletype as the input parameter device, he can delimit the 
parameter code by typing CTRL D (tD). MACRO responds with EOTfP. The user 
should then ready the input device assigned to .DAT-11 and type CTRL P. MACRO 
immediately begins assembling programs* 
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5.4 COMMAND STRING 


The command string format consists of a string of options, followed by a left arrow, followed by the program 
name, followed by a terminator. 

OPTIONS - FILE NAME 

The format for the option string is flexible; that for the program name after the left arrow is fixed. Some ex¬ 
amples of the command string are given below. Terminating the command string with a carriage return will 
cause MACRO to re-initialize itself to PASS I at the completion of assembly. Terminating the command string 
with ALT MODE will cause a return to the MONITOR at the end of assembly. 

Example 1: 


P,L,S,B-FILE 

Example 2: 

CAB L,.S, N,P V P,P,P HELLO GE-FILE1 

The option designators may be typed in any sequence so long as they appear on the same line. A file name 
must be typed. All characters to the left of the left arrow which do not represent valid options are ignored. 

Example 3: 


-FILE! 

No options are required in the command string. If no options or® specified, it is assumed that the programmer 
is assembling for errors; therefor©, all assembly errors are printed on the device assigned to .DAT-12. If a com¬ 
mand string error occurs, the whole line must be retyped, starting with the command string options. 

5.4.1 Program Name 

A program name may consist of up to six characters, followed by a space, followed by not more than a three- 
character extension (additional characters are ignored). All of the legal printing characters (refer to Appendix 
A) may be used in any order. The first non^space character to be typed after the command string left arrow («*) 
is recognized as the first character of the name. If a space is typed after at least one printing character, the 
next three characters are interpreted as the extension. If two spaces are typed after at least one printing 
character, all subsequent characters are ignored and the extension SRC is assumed. If no space follows a 
six-character name, the first three characters immediately following are interpreted as the extension. If a 
carriage return follows the name, the extension SRC is assumed. 
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Examples: 


User Command String Macro Interpretation 



Name 

Extension 

*-1—i ABCDEFi_j GH !) 

ABCDEF 

GHI 

-ABujCDEJ 

AB 

CDE 

U 1—1 Ji a - I ABC LJ ID J 

ABC 

! D 

^ABC i_j u DEF J 

ABC 

SRC 

“A J 

A 

SRC 

-ABCDEFGHIJ J 

ABCDEF 

GHI 

-ABCDEFG J 

ABCDEF 

G 

-ABCDEFGH t_i IJKL J 

ABCDEF 

IJK 

-ABCDEFGHs_i J 

ABCDEF 

SRC 


5.4.2 Options 

As illustrated in the examples, the options may be used in any combination or not at all. If no options are 
desired, - is sufficient, and output is limited to assembly error messages on the device assigned to .DAT-12. 
The following table shows the action and the default of the options. 


Option 

B 

L 

P 


N 

A 

V 


S 


Action 

Generate a binary file 

Generate a listing file on the requested 
output device. 

Before assembly begins, read program 
parameters from DAT SLOT-10. If the 
device is file-oriented, the file name 
must be . PARAM SRC. The code read 
from DAT SLOT-10 is read only once; 
for this reason, only direct assignments 
may be used. 

Number each source line (decimal). If 
this option is used, it is not necessary to 
type the L option. 

Print symbols at end of PASS 2 in alpha¬ 
numeric sequence. 

Print symbols at end of PASS 2 in value 
sequence. 


Same as selecting both A and V above. 


Default Action 

A binary file is not generated. 

A listing file is not generated 
(see options N,C). 

No parameters, begin assembly 
iimmediately after command string 
termination. 


Source lines are not numbered. 


Symbols are not printed in alpha¬ 
numeric sequence. 

Symbols are not printed in value 
sequence. (If neither option V nor 
A is requested, symbols are not 
printed.) 

Symbols are not printed. 
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Default Action 


Option 


Action 


C 


G 

X 


Program areas that fall between unsatis¬ 
fied conditionals are not printed. It is 
not necessary to type the L option if this 
option is used. 

Print only the source line of a macro 
expansion. It is not necessary to type 
L option. 

At completion of PASS 2, PASS 3 is 
loaded to perform the cross-referencing 
operation; it is not necessary to type 
the L or N option if this option is used. 
At completion of PASS 3 the Assembler 
will call in PASS 1 and 2, to continue 
assembling programs. If the command 
string was terminated by an ALT MODE, 
control will return to the Monitor at the 
end of assembly. 


All source lines are printed. 


Generate printouts for macro expan 
sions and expandable pseudo-ops 
(e.g., .REPT) 

A cross-reference is not provided 
and PASS 3 is not called in. 


5.5 ASSEMBLY LISTINGS 

If the user requests a listing via the command string, the Assembler will produce an output listing on the 
requested output device. The top of the first page of the listing will contain the name of the program as given 
in the command string. The body of the listing will be formatted as follows. 


Line 

Number 

Error 

Flags 

Location 

Address 

Mode 

Object 

Code 

Address 

Type 

Source 

Statement 

xxxx 

XXX 

xxxxx 

[R] 

xxxxxx 

[ R3 

X 

X 




[A] 


[A] 








[E] 




where: 


Line Number = 


Flags = 
Location = 


Each source line is numbered (decimal), comments lines and generated 
lines are not included. Lines are not numbered unless the X or N 
option is specified. 

Errors encountered by the assembler 

Relative or absolute location assigned to the object code. 


Address Mode = 


Indicates the type of user address. 


A = absolute 
R - relocatable 


Object Code = The contents of the location (in octal) 

Address Type = Indicates the classification of the object code. 

A = absolute 
R = relocatable 
E = external 


The object codes assigned for literals and external symbols are listed following the program. 
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5.6 SYMBOL TABLE OUTPUT 


At the end of PASS 2, the symbol table may be output. If the A option is used, the table will be printed in 
alphanumeric sequence; if the V option is used, the symbol table will be printed in numeric value sequence; 
if the S option is used, the symbol table will be output in both alphanumeric and numeric sequence. The format 
is as follows: 


Symbol 

Value 

Type 

SYMBL1 

XXXXX 

E 

SYMBL2 

XXXXX 

R 

DIRECT 

XXXXXX 

A 
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The Xs represent the value assigned to the symbol. This is usually the location where the value is defined. 

Note that for SYMBL1 and SYMBL2 there are five Xs but that there are six Xs for the symbol DIRECT. Symbols 
having six octal numbers to represent their values are directed assignments. 

The symbol table show* the type of symbol: 

A = absolute 
R = relocatable 
E = external 

Locations assigned to variables immediately precede the last object code producing statement in the assembled 
program. Locations and object codes assigned for literals and external symbols are listed immediately following 
the variables; if no variables are used in the program, they immediately follow the program. 


5.7 RUNNING INSTRUCTIONS 

Once the Assembler has identified itself, it is ready to perform an assembly. Proceed as follows: 

a. Place the source program to be assembled on the appropriate input device. (If paper tape, push 
the tape-feed button to clear the end-of-tape flag.) 

b. Type the command string. 


5.7.1 Paper Tape Input Only 

The following steps are required when the source program is encountered in the paper tape reader: 

a. At the end of PASS 1, MACRO types 

END PASS 1 

tP 

b. Replace the source tape in the reader, pushing the tape-feed button to clear the end-of-tape flag. 

c. Type CTRL P to start PASS 2. 

At the end of PASS 2, PASS 3 will be loaded by the Assembler to perform the cross-referencing operation if the 
X option is requested* At completion, PASS 1 and 2 will be reloaded to assemble additional programs* 


5.7.2 Cross-Reference Output 

When a cross reference output is requested, the symbols are listed in alphabetic sequence. The first address 
after the symbol is the location where the symbol is defined. Ail subsequent locations represent the line number 
(decimal) where the symbol was referenced. Leading zeros are suppressed for the cross-reference symbol table. 
Ten locations are printed on one line and subsequent locations are continued on the next line. 
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Example: 


PAGE 

A 1 XXXXX XXXXX.XXXXX 

XXXXX XXXXX 

B 5000 XXXXX 

SYMBOL 100 XXXXX 


5.8 PROGRAM RELOCATION 

The normal output from the MACRO-15 Assembler is a relocatable object program, which may be loaded into 
any part of memory regardless of which locations are assigned at assembly time. To accomplish this, the address 
portion of some instructions must have a relocation constant added to it. This relocation constant, is added to 
it. Th is relocation constant, is added at load time by linking the loader; it is equal to the difference between 
the memory location that an instruction is actually loaded into and the location that was assigned to it at 
assembly time. The Assembler determines which storage words are relocatable (marking them with an R in the 
listing), which are absolute (marking these non-r@locatable words with an A) and which are external (marking 
these with an E). The rules that the Assembler follows to determine whether a storage word is absolute or relo¬ 
catable are as follows. 

a. If the address is a number (not a symbol), the address is absolute. 

b* If the address is a symbol which is defined by a direct assignment statement (i =) and the right- 
hand side of the assignment is a number, all references to the symbol will be absolute. 

c. If a user label occurs within a block of coding that is absolute, the label is absolute. 

d. Variables, undefined symbols, external transfer vectors, and literals get the same relocation as was 
in effect when .END was encountered in PASS 1. 

e„ If the location counter (.LOC pseudo-op) references a symbol which is not defined in terms of an 
absolute address, the symbol is relocatable* 

f 8 All others are relocatable* 

The following table depicts the manner in which the Assembler handles expressions which contain both absolute 
and relocatable elements: 

(A=absolute, R=relocatabie) 

A + A = A 
A - A = A 
A+R-R 
A - R= R 
R+ A- R 
R - A = R 

R + R = R and flagged as possible error 
R - R= A 
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If multiplication or division is performed on a relocatable symbol, it will be flagged as a possible relocation 
error . 

If a relocatable program exceeds 4K, the following warning message will be typed at the end of PASS 2: 
*WARNING*PROG> 4K 

5.9 ERROR CONDITIONS AND RECOVERY PROCEDURES 

Printout Recovery Procedure 

IOPS 4 Device is not ready. Ready device and type 

CTRLR(?R) 

IOPS 0-61 unrecoverable I/O error. Type CTRL P 
to restart MACRO or type CTRL C to return to the 
Monitor. 


5.9.1 Restart Control Entries 

CTRL P Restart Assembler, if running 

CTRL C Return to Monitor 

5.10 ERROR DETECTION 

MACRO“15 examines each source statement for possible errors. The statement which contains the error will be 
flagged by one or several letters in the left-hand margin of the line, or, if the lines are numbered, between 
the line number and the location. The following table shows the error flags and their meanings. 

Flag Meaning 

A Error in direct symbol table assignment; assignment ignored. 

B a. Memory bank error (program segment too large) 

b. Page error - the location of an instruction and the address it refer¬ 
ences are on different pages. 

D The statement contains a reference to a multiply defined symbol. It is 

assembled with the first value defined. 

E Erroneous results may have been produced; will also occur on undefined 

. END value. 

I Line ignored. 

a. Relocatable pseudo-op in absolute program 

b. Redundant pseudo-op 

c * Absolute pseudo-op in relocatable program 

d. Absolute pseudo-op appears after a line has been assembled * 
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Meaning 


Flag 

L a. Literal phasing error. Literal encountered in PASS 2 does not equal 

any literal encountered in PASS 1. 

b. Nested literals are illegal, 

M An attempt is made to define a symbol which has already been defined. 

The symbol retains its original value. 

N Error in number usage. 

P Phase error. PASS 1 value does not equal PASS 2 value of a symbol. 

PASS 1 value will be used. 

Q Questionable line* The address field has been delimited by a space or 

tab and is followed by another symbol „ 

R Possible relocation error. 

S Symbol error. An illegal character was encountered and ignored. 

T Tag error a. X used as tag • 

b. An illegal character was encountered in tag field. 

U Undefined symbol. 

W Line overflow during macro expansion. 

X a. Illegal usage of macro name. 

b. Illegal use of index register. 

In addition to flagged lines, there are certain conditions which will cause assembly to be terminated prematurely. 
Message 

TABLE OVERFLOW 
CALL OVERFLOW 


Pass Cause 

I or 2 Too many symbols and/or macros. 

1 Too many embedded macro calls* 
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APPENDIX A 
CHARACTER SET 


Printing 

Character 

1 

1 

6 —bit 
Trimmed 

ASCII 

Printing 

Character 

7-bit 

ASCII 

6-bit 

Trimmed 

ASCII 

a 

100 

00 

Form Feed 

014 


A 

101 

01 

Carriage Return 

015 


B 

102 

02 

ALT MODE (ESC) 

175 


c 

103 

03 

Rubout 

177 


D 

104 

04 

(Space) 

040 

40 

E 

105 

05 

! 

041 

41 

F 

106 

06 

K 

042 

42 

G 

107 

07 

# 

043 

43 

H 

no 

10 

$ 

044 

44 

i 

m 

11 

% 

045 

45 

j 

112 

12 

& 

046 

46 

K 

113 

13 

r 

047 

47 

L 

114 

14 

( 

050 

50 

M 

115 

15 

) 

051 

51 

N 

116 

16 

* 

052 

52 

o 

117 

17 

+ 

053 

53 

p 

120 

20 


054 

54 

Q 

121 

21 


055 

55 

R 

122 

22 


056 

56 

S 

123 

23 

/ 

057 

57 

T 

124 

24 

0 

060 

60 

U 

125 

25 

1 

061 

61 

V 

126 

26 

2 

062 

62 

w 

127 

27 

3 

063 

63 

X 

130 

30 

4 

064 

64 

Y 

131 

31 

5 

065 

65 

z 

132 

32 

6 

066 

66 

[* 

133 

33 

7 

067 

67 

\ 

134 

34 

8 

070 

70 

]* 

135 

35 

9 

071 

71 

f * 

136 

36 

.* 

072 

72 


137 

37 


073 

73 

Null 

000 


< 

074 

74 

Horizontal Tab 

on 


= 

075 

75 

Line Feed 

012 


> 

076 

76 

Vertical Tab 

013 


? 

i 

077 

77 


♦Illegal as source, except in a comment or text. All other characters are illegal to MACRO-15 and are flagged 
and ignored. 











APPENDIX B 
PERMANENT SYMBOL TABLE 


OPR 

NOP 

CMA 

CML 

OAS 

RAL 

RAR 

IAC 

HLT 

XX 

SMA 

SZA 

SNL 

SML 

SKP 

SPA 

SNA 

SZL 

SPL 

RTL 

RTR 

SWHA 

CLL 

STL 

CCL 

RCL 

RCR 

CLA 


Operate 

CLC 

750001 

JMP 600000 

740000 

LAS 

750004 

Automatic Priority 

740000 

LAT 

750004 

Interrupt Type KF09A 

740001 

GLK 

750010 

SPI 705501 

740002 

LAW 

760000 

ISA 705504 

740004 

EAE Type KE09A 

Index Instructions 

Which Take an Immediate 

740010 

EAE 

640000 

Nine-bit Operand 

740020 


IOTs 

AAC 723000 

740030 

IOT 

700000 

AXR 737000 

740040 

IORS 

700314 

AXS 725000 

740040 

DBK 

703304 

Index and Limit Register 
Instructions Which do 

740100 

DBR 

703344 

not use Operands 

740200 

IOF 

700002 

CLLR 736000 

740400 

ION 

700042 

PAL 722000 

740400 

CAF 

703302 

PAX 721000 

741000 

RES 

707742 

PLA 730000 

741100 

Memory Reference 

PLX 731000 

741200 

CAL 

000000 

PXA 724000 

741400 

DAC 

040000 

PXL 726000 

741400 

JMS 

100000 

CLX 735000 

742010 

DZM 

140000 

Mode Switching 

742020 

LAC 

200000 

EBA 707764 

742030 

XOR 

240000 

DBA 707762 

744000 

ADD 

300000 

Index Register 

744002 

TAD 

340000 

Value 

744002 

XCT 

400000 

X 10000 

744010 

ISZ 

440000 


744020 

AND 

500000 


750000 

SAD 

540000 
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APPENDIX C 

MACRO-15 CHARACTER INTERPRETATION 


Character 


Function 

Name 

Symbol 


Space 


Field delimiter. Designated by ^ in this manual. 

Horizontal tab 

H 

Field delimiter. Designated by -®j in this manual. 

Semicolon 

t 

Statement terminator 

Carriage return 

) 

Statement terminator 

Plus 

+ 

Addition operator (two's complement) 

Minus 

- 

Subtraction operator (addition of two’s complement) 

Asterisk 

* 

Multiplication operator or indirect addressing indicator 

Slash 

/ 

Division operator or comment initiator 

Ampersand 

& 

Logical AND operator 

Exclamation point 

i 

Inclusive OR operator 

Back slash 

\ 

Exclusive OR operator 

Opening parenthesis 

( 

Initiate literal 

Closing parenthesis 

) 

Terminate literal 

Equals 

= 

Direct Assignment 

Opening angle bracket 

< 

Argument delimiter 

Closing angle bracket 

> 

Argument delimiter 

Comma 

/ 

An argument delimiter in MACRO definitions or an 
exclusive OR operator. 

Question mark 

? 

Create symbol designator in macros 

Quotation marks 

ii 

Text string indicators 

Apostrophe 

i 

Text string indicator 

Number Sign 

# 

Variable indicator 

Dollar sign 

$ 

Real argument continuation 

Line feed 

non-printing j 


form feed 

. . 1 
non-printing 

\ not applicable 

Vertical tab 

non-printing ■ 

I 
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Character 


Function 


Null Blank Character. Ignored by the Assembler 

Delete Rubout character. Ignored by the Assembler 


Illegal Characters 

Only those characters listed on the preceding table are legal in MACRO-15 source programs, all other characters 
will be ignored and flagged as errors. The following characters, although they are illegal as source, may be 
used within comments or in .ASCII and .SIXBT pseudo-ops. 


Character Name Symbol 

Commercial at @ 

Opening square bracket [ 

Closing square bracket ] 

Up arrow t 

Left arrow ♦* 

Colon : 
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APPENDIX D 

SUMMARY OF MACRO-15 PSEUDO-OPS 


Pseudo-op 

Section 

Format 

Function 

.ABS 
. ABSP 

3.2.1 

3.2.1 

H .ABS HnldJ 

H .abspH nldj 

Object program is output in absolute, 
blocked, checksummed format for 
loading by the Absolute Binary Loader 

.ASCII 

3.8.1 

label H .ASCII,_,/text/<octa 1 >J 

Input text strings in 7 —bit ASCII code, 
with the first character serving as de¬ 
limiter. Octal codes for nonprinting 
control characters are enclosed in 
angle brackets. 

.BLOCK 

3.5 

label H .BLOCK H exp J 

Reserves a block of storage words equal 
to the expression. If a label is used, 
it references the first word in the block. 

.DBREL 

3.2 

H . DBREL J 

Disable bank mode relocation • 

.DEC 

3.4 

H . DEC J 

Sets prevailing radix to decimal. 

.DEFIN 

3.16 

H .DEFIN. .macro name, args J 

Defines macros. 

.DSA 

3.11 

label H .DSA, .exp J 

Defines a user symbol which is to be 
used only in the address field. 

.EBREL 

3.2 

H .EBREL J 

Enable bank mode relocation® 

. EJECT 

3.14 

H .EJECT J 

Skip to head of form on listing device. 

.END 

3.6 

H • END u START J 

Must terminate every source program. 
START is the address of the first in¬ 
struction to be executed. 

. ENDC 

3.13 

H . ENDC ^ 

Terminates conditional coding in .IF 
statements. 

. ENDM 

3.16 

H .ENDM J 

Terminates the body of a macro 
definition. 

.EOT 

3.7 

H -eot; 

Must terminate physical program seg¬ 
ments, except the last, which is ter¬ 
minated by . END. 

.ETC 

3.16 

H . ETC ^args,args J 

Used in macro definitions to continue 


the list of dummy arguments on suc¬ 
ceeding lines. 
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Pseudo-op 

Section 

Format 

Function 

.FULL 
.FULLP 

3.2.2 

3.2.2 

H .FULLJ 

H .FULLPJ 

Produces absolute, unblocked, un¬ 
check summed binary object programs. 
Used only for paper tape output. 

. GLOBL 

3.9 

H -GLOBL. .sym,sym,sym J 

Used to declare all internal and ex¬ 
ternal symbols which reference other 
programs. Needed by Linking Loader. 

.IFxxx 

3.13 

H -IFxxx^exp^ 

If a condition is satisfied, the source 
coding following the .IF statement and 
terminating with an .ENDC statement 
is assembled. 

. IODEV 

3.10 

H . IODEV.DAT numbers J 

Specifies .DAT slots and associated 

I/O handlers required by this program. 

.LOG 

3.3 

^ -LOC^expJ 

Sets the location counter to the value 
of the expression. 

.OCT 

3.4 

H .OCT J 

Sets the prevailing radix to octal. 
Assumed at start of every program. 

.REPT 

3.12 

• REPT^count, n) 

Repeats the object code of the next 
object code generating instruction 

Count times. Optionally, the gener¬ 
ated word may be incremented by n 
each time it is repeated. 

. SIXBT 

3.8.2 

label H .SIXBT g a /text/<octal >J 

Input text strings in 6-bit trimmed 

ASCII, with first character as de¬ 
limiter. Numbers enclosed in angle 
brackets are truncated to one 6-bit 
octal character. 

.SIZE 

3.15 

H .size; 

MACRO-15 outputs the address of last 
location plus one occupied by the 

object program. 

.TITLE 

3.1 

H . TITLE^name and/or J 
any comments 

The first six legal symbol characters 
are printed as header of the program 
listing. A space, tab, or a carriage 
return will delimit the name. 

.NOLST 

.LST 

3.17 

3.17 

H. NOLST J 

H-lstj 

Terminate requested assembly listing 
output of source lines of code contained 
between .NOLST and .LST® 


© 
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APPENDIX E 
SUMMARY OF SYSTEM MACROS 


System macros (Monitor commands) are defined in the Monitor manual; and are summarized here for the 
convenience of the PDP-15 programmers. 

System macros are predefined to MACRO-15. To use a system macro, the programmer writes a macro call state¬ 
ment, consisting of the macro name and a string of real arguments. 

To initialize a device and device handler 
H .INIT^a,f,r 

where a = .DAT slot number in octal 

f = 0 for input files; 1 for output files 
r = user restart address* 


To read a line of data from a device to a user's buffer 


H . READ^ a,m , I ,w 

where a - .DAT slot number in octal 

m = a number, 0 through 4, specifying the data mode: 

0 = IOPS binary 

1 = Image binary 

2 - IOPS ASCII 

3 = Image alphanumeric 

4 = Dump mode 

I = line buffer address 


w 


word count of the line buffer in decimal, including 
two-word header 


To write a line of data from the user's buffer to a device 

H . WRITE t _ J a,m,l ,w 

where a - .DAT slot number in octal 

m = a number, 0 through 4, specifying the data mode: 

0 = IOPS binary 
1 - Image binary 

* Meaningful only when device associated with .DAT slot a is the Teletype. Typing CTRLP on the keyboard will 
force control to location r. 
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2 = lOPS ASCII 

3 = Image alphanumeric 

4 = Dump mode 

I - line buffer address 

w = word count of line buffer in decimal, including the two- 
word header 


To detect the availability of a line buffer 
H .WAIT^a 

where a - .DAT slot number in octal. After the previous .READ, 
.WRITE, or .TRAN command is completed, .WAIT re¬ 
turns control to the user at LOC+2 


To detect the availability of a line buffer and transfer control to ADDR if not available 

H .WAITR^a, ADDR 

where a = DAT slot number (octal radix) 

ADDR = Address to which control is transferred if buffer is not available. 


To close a file 


H .CLOSE 

where a = .DAT slot number in octal 


To set the real-time clock to n and start it. 

H .TIMER. n,c 

where n ” number of clock increments in decimal. Each increment 

is 1/60 second (in 60-cycle systems) or 1/50-cycle systems) 

c = address of subroutine to handle interrupt at end of interval 


To return control to Keyboard Monitor, or halt in I/O Monitor environment 


H . EXIT J 


MASS STORAGE COMMANDS FOR DECTAPE, MAGNETIC TAPE, 

DISK AND DRUM ONLY 

To search for a file , and position the device for subsequent .READ commands 
H • SEEK ^a.d 

where a - .DAT slot number in octal 

d = address of user directory entry block 
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To examine a file directory, find a free directory entry block and transfer the block to the device 


H .ENTERd 

where a = .DAT slot number in octal 

d = address of user directory entry block 

To dear a file directory to zero 


H.CLEAR^a 

where a = .DAT slot number in octal 


To rewind^ backspace; skip; write end-of-file, or write blank tape on nonfile-oriented magnetic tape 
H . MTA PE a a f xx 

where a = .DAT slot number in octal 

xx - a number; 00 through 07, specifying one of the functions 
shown below 

00 = Rewind to load point* 

02 = Backspace one record* 

03 = Backspace one file 
04 = Write end-of-file 
05 = Skip one record 
06 = Skip forward one file 
07 = Skip to logical end-of-file 

or a number; 10 through 16, to describe the tape configuration 

10 = Even parity, 200 bpi 

11 = Even parity, 556 bpi 

12 = Even parity, 800 bpi 

14 = Odd parity, 200 bpi 

15 = Odd parity, 556 bpi 

16 = Odd parity, 800 bpi 


To read from, or write to any user file-structured mass storage device 


H •TRAN fc _ J a,d,b,l,w,p 


where 


a = .DAT slot number in octal 
d = transfer direction: 

0=lnput forward 

l=0'utput forward 

2=Input reverse (DECtape only) 

3=Output reverse (DECtape only) 
b = device address in octal, such as block number for DECtape 
I = core starting address 
w = word count in decimal 
p = platter number (DECdisk only) 


May be used with any non-file-structured mass storage device. 




To delete a file 


H .DLETE u a,d 

where a = .DAT slot number in octal 

d = starting address of the three-word block of starve in user area 
containing the file name and extension of file to be deleted 
from the device. 


To rename a file 

H • RENAMES,d 

where a = .DAT slot number in octal 

d = starting address of two three-word blocks of storage in user 
area containing the file names and extensions of the file to 
be renamed, and the new name, respectively. 


To determine whether a file is present on a device 
A .FSTATd 

where a = .DAT slot number 

d = starting address of three-word block in user area containing 

the file name and extension of the file whose status is desired. 


BACKGROUND/FOREGROUND MONITOR SYSTEM COMMANDS 
To read a line of data from a device to a u$er 8 s buffer in real-time 


H .REALR„ a a,nJ,w,ADDR,p 

where a = DAT slot number in octal 

m = Data mode specification 

0 = IOPS binary 

1 = Image binary 

2 = IOPS ASCII 

3 = Image Alphanumeric 

4 = Dump mode 

I = Line buffer address 


w = word count of line buffer in decimal, including the two-word leader 

ADDR = 15-bit address of closed subroutine that is given control when the 
request made by . REALR is completed . 

p = API priority level at which control is to be transferred to ADDR: 

0 = mainstream 

4 = level of .REALR 

5 = API software level 5 

6 = API software level 6 

7 = API software level 7 


To write a line of data from user 8 ! buffer to a device in real time 



H .REALWm,I,w,ADDR,p 

where a = DAT slot number in octal 
m = Data mode specification 

0 = IOPS binary 

1 = Image binary 

2 = IOPS ASCII 

3 = Image Alphanumeric 

4 = Dump mode 


I = line buffer address 

w = word count of line buffer in decimal, including the two-word leader 

ADDR = 15-bit address of closed subroutine that is given control when the 
request made by .REALW is completed 

p = API priority level at which control is to be transferred to ADDR 


0 = mainstream 
4= level of .REALR 

5 = API software level 5 

6 = API software level 6 

7 = API software level 7 


To indicate , in a FOREGROUND job, that control is to be relinquished to a BACKGROUND job 
H .IDLE 


To set the real-time clock to n and start it 
H .TIMER^n,c,p 

where n = number of clock increments in decimal. Each increment is 1/60 
of a second (1/50 in 50 Hz systems) 

c = address of subroutine to handle interrupt at end of interval 

p = API priority level at which control is to be transferred to c 

0 = mainstream 
4= level of .TIMER 

5 = API software level 5 

6 - API software level 6 

7 = API software level 7 





To exit from all real-time subroutines which were entered via ^REALR^ „REALW, oTIMER^ or real-time CTRL P 
requests * 

*RLXIT ad dr 

where addr = The 13-bit entry point address of the real-time subroutine from 
which an exit is to be made. 


E-5 






APPENDIX F 

SOURCE LISTING OF THE ABSOLUTE BINARY LOADER 


/*•** ABSOLUTE BINARY 
/ .FULL 


700004 

CLCF=700004 


7001 12 

n it B “ 7 0 0 1 1 2 


700144 

RSB=700144 


700101 

RSF = 700101 


017720 

LDSTNT = 1 7720 


703302 

BINLDK CAP 


700004 

CLOP 


700012 

I0F+1W 

705504 

ISA 


740000 

LODMOD NOP 


707702 

707702 

017726 

LDNXBKsl7726 


157775 

dzp 

LOCKSP 

117753 

JKS 

LDhEAD 

057776 

DAC 

LDSTAD 

741100 

SPA 


617747 

JPP 

LDXFR 

117753 

JfcS 

LDhEAD 

057777 

DAC 

LDlvDCT 

117753 

J 

LDrtFJAD 

017736 

LDNX'..'r) = l 7736 

117753 

JKS 

LDhEAD 

077776 

DAC * 

LDSTAD 

457776 

ISZ 

LDSTAD 

457777 

ISZ 

LDWDCT 

617736 

JPP 

LDNXWD 

357775 

TAD 

LDC-KSN 

740200 

SZA 


740040 

HLT 


617726 

JNP 

LDNXBK 

017747 

LDXFR-l7747 


057777 

DAC 

LDWDCT 

457777 

ISZ 

LDWDCT 

617763 

JKP 

LDWAIT 

740040 

HLT 


017753 

LDKEAD=17753 


LOADED *** 


/CLEAR FLAGS 
/CLOCK OFF 
/INTERRUPT OFF 
/TURN OFF AH I 
/CtbA )j (DBA ) > <NOP ) 

/PDH-9 C OPPAT IbILITY C FEE > 

/CHECKSl'PNING LOCATION 

/GET STARTING ADDRESS 
/BLOCK HEADING OR 
/STArtT BLOCK 

/WGrtD COUNT < 2 ' S CCf-.PLEPENT > 


/LOAD DATA INTO APPROPRIATE 
/PEPOKY LOCATIONS 
/FINISHED LOADING 
/NO 

/LOCKSP SHOULD CONTAIN V) 

/C HECKS LIP. ErkOk HALT 
/PRESS CONTINUE TO IGNOhE 


/EXECUTE START ADDRESS 

/NO ADDRESS ON .END STATEMENT 

/PANUALLY START USER PKGGrAP 
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000000 

0 


700S 44 

RSB 


357775 

TAD LDCKSM 


057775 

DAG LOCKSK 


700101 

KSF 


617757 

Jiyp LDKEAD+4 


7001 12 

RRB 


637753 

JFP^ LDRFAD 



/THE LAST FRAf^E OF EVERY 

aAt?S(P) PROG is garbage® 

017763 

LDWAIT»17763 


117753 

Jf*£ LDREaD 

/PASS OVER LAST FRAME CPDH-9 

637776 

JMP* LDSTAD 

/C OR PAT IbILITY)* 

mf 235 

FNDLDR*. 


003500 

000000 

HRFiWD 003 5001 0 

/header 

00026S 
000277 

26SI 277 

/HhiY START 

000320 

3201 0 



03 (5) (V?53 

017775 LDCKSN =! 7775 

017776 LOST AD = 177 76 

017777 LDVvDCT = 1 7777 

/ • ?ND hIN'LDK 

/*** 0 Nil) OF LOAD^K *** 
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APPENDIX G 
MACRO!*” 15 ASSEMBLER 


The 8K DECfape systems cannot utilize MACRO-IS if a binary output on DECtape is desired, since the combined 
size of MACRO-15, the Resident Monitor, and the required DECtape device handler (DTB*) is nearly 8K. 
Therefore, there is no space available for the User's Symbol Table* If, however, paper-tape I/O or DECtape 
input/paper-tape output is desired, MACRO-15 may be used* Device handlers DTC, PRB, PPC or PPB (for 
,ABS or .FULL programs) may be used as required* 

The MACROI-15 assembler, which is a device-dependent version of MACRO-15, does permit DECtape I/O on 
an 8K machine* This is possible because MACROI, though identical to MACRO in function, uses self-contained 
DECtape and Teletype I/O routines * This results in a core load which operates in 8K and allows approximately 
410^p locations for the User's Symbol Table* 

DEVICE ASSIGNMENTS 

Since MACROI is device-dependent, the user may not use the Monitor ASSIGN command* The assembler 
performs l/O in the manner described below (as modified by the D, U, and T options): 

a* The user's source program is input from DECtape Unit 1 * 

b* The assembled binary Is output to DECtape Unit 2* 
c* The assembly listing is output to the Teletype, 
do The parameter file is input from DECtape Unit 1 . 


OPERATION 

The operating features of MACROI are the same as described in Chapter 5 for MACRO, wtth the following 
exceptions: 

Calling Procedure 

MACROI is called by typing MACRO!/ after the Monitor's $ request* When the assembler has been loaded, 
it identifies itself by fyping: 

MACRO/I Vnn 
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on the Teletype and then waits for a command string. 


NOTE 

The command line editing function CTRL U deletes the 
entire line and echoes tU and a carriage return/line 
feed operation on the Teletype, 


Additional Options 

The following options may be used in the command string to MACROI along with the normal MACRO options 


Option 

D 

U 

T 


Action 

Disregard the B option and output 
the assembly listing on DEC tape 
Unit 2. 

The assembled binary is output to 
DECtape Unit 1. 

Accept parameters from the 
Teletype, 


Default Action 

A binary, if desired, may be output 
to DECtape 2, The listing is output 
to the Teletype, 

The assembled binary is output to 
DECtape Unit 2 if B option is selected. 

Parameters are accepted from DECtape 
Unit 1 . 


Error Conditions 

MACROI performs I/O error checking, and outputs the following messages: 


Message 

Meaning 

IOPS 0 

Illegal CAL 

IOPS I 

CAL* Illegal 

IOPS 3 

Illegal Interrupt 

IOPS 4 

DECtape unit not ready - type CTRL 

IOPS 12 

Unrecoverable DECtape Error 

IOPS 13 

Rle Not Found 

IOPS 14 

Directory Full 

IOPS 15 

DECtape Full 

IOPS 23 

Illegal Word Pair Count 

IOPS 61 

Input Parity Error While Reading Din 


Al! of the above error messages, except IOPS 4, are terminal . Type CTRL P to restart MACROI or type 
CTRL C to call in the Monitor. A more complete description of IOPS errors may be found in the Monitor 
System Manuals or User's Guides listed in the Preface of this manual. 
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MACRO-15 INDEX 


A AC, A AS, AXR, AXS, 2-24 
.ABSP, 2-19, 3-2, 3-4 
.ABS, 2-19, 3-2, 3-4 
.ABS oddress error, 3-3 
absolute (A), 5-5 

Absolute addresses (non-re!©eatable), 1-1 
absolute binary loader, 3-2, -3 
Absolute Binary Loader Source Listing, F-l 
absolute pseudo ops (.ABS, .ABSP), 3-2 
absolute storage word, 5-6 
Address Assignments, 2-11 
Indexed Addressing, 2-12 
Indirect Addressing, 2-12 
Literals, 2-13 

Referencing the Location Counter, 2-12 
location counter, 2-11 
machine instructions, 2-11 
sfwage words, 2-11 

* 

Address Field, 2-18 
bank addressing, 2-19 
carriage return/!ine feed, 2-18 
delimiters, 2-16, 2-17, 2-18 
error condition, 2-19 
op code, 2-18 
pseudo op code, 2-18 
semicolon, 2-18 
slash, 2-19 
space, 2-18 
tab, 2-18 
terminator, 2-18 

address field, 2-1, 2-2, 2-6, 2-13 
address link, 2-13 
address mode, 5-4 
address type, 5-4 
ALT MODE, 5-2 


angle brocket (<), 3-8, 4-5 
apostrophe (' ), 3-8 

Argument Delimiters and Terminators, 4-5 
angle brackets (<), 4-5 
carriage return ( } ), 4-5 
comma ( , ), 4-5 
space ( i_j ), 4-5 
tab ( H ), 4-5 
arithmetic operator, 2-9 
.ASCII, 4-3 

ASCII characters 6-bit trimmed, 3-8 
.ASCII pseudo op, 3-7 
.ASCII statements, 3-8 
Assembler operations, 2-7 
Assembler Priority List, 2-25 
machine ops, 2-25 
PASS1, 2-25 
pseudo ops, 2-25 
system macros, 2-25 
Assembler Processing, 1-2 

executable object program, 1-2 
externaS symbol, 1-2 
standard object code, 1-2 
three pass operation, 1-2 
two pass operation, 1-2 
Assembly Listings, 5-4 
address mode, 5-4 
address type, 5-4 
flags, 5-4 
line number, 5-4 
location, 5-4 
object code, 5-4 
asterisk, 2-12, 2-17, 2-18 
at sign (@), 2-3 
auto index registers, 2-20 
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bank addressing, 2-19, 3-3 

bank bits, 2-23 

bank error, 2-12 

bank mode, 2-23 

base 8, 2-8, 3-5 

base 10, 3-5 

bit 4, 2-17 

blank line, 2-20, 2-21 
.BLOCK, 3-4, 3-6 
block body, 3-2 
block heeding, 3-2 
Boolean operator, 2-9 
bracket, see angle bracket 

Catling Procedure, 5-1 

carriage return ( J ), 2-1, 3-8, 4-3, 4-5 

carriage return/line feed, 2-15, 2-18, 2-20 

Character Interpretation, C-l, C-2 

characters, 2-3 

Character Set table, A-l 

6- bit trimmed ASCII, A-l 

7- bit ASCII, A-l 
codes (octal), 3-8 
colon (:), 2-3 
comma ( ,), 4-5 
Command String, 5-2 

Options, 5-3 
Program Norms, 5-2 
ALT MODE, 5-2 
command string error, 5-2 
left arrow, 5-2 
option string format, 5-2 
program norm format, 5-2 
command string error, 5-2 
.COMMENTS, 3-2 


comments, 2-2, 2-3, 2-8, 4-2 
Comments Field, 2-20 
blank line, 2-20, 2-21 
carriage return/line feed, 2-20 
semicolon (;), 2-20, 2-21 
space ( u), 2-20, 2-21 
tab ( H ), 2-20, 2-21 
comments field, 2-1, 2-3 

Conditional Assembly (.IF xxx and . ENDC), 3-12 
conditional statements, 3-13 
IF statements, 3-13 
nested conditional statements, 3-13 
nested IF statements, 3-13 
recursive macro calls, 3-14 
conditional assembly statement, 4-10 
conditional statements, 3-12, 3-13, 3-14 
continuation lines, 4-4 
Created Symbols, 4-6 
dummy argument, 4-6 
question mark ( ?), 4-6 
symbolic tag, 4-6 
count, 3-11 

Cross Reference Output, 5-5 
CTRL D (tD), 5-1 
CTRL P (?P), 5-1 
CTRL U (@), 5-1 

DAT (Device Assignment Table), 3-10 
DBA instruction, 3-3 

.DBREL (disable bank mode relocation), 3-1, 3-4 

.DEC (Decimal), 2-8, 3-5 

.DEC pseud© op, 2-9 

decimal integer, 2-9 

decimal radix, 2-9 

decimal values, 2-8 
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defer bit, 2-12, 2-17 
.DEFIN, 3-14, 4-2 
.DEFIN statement, 4-2, 4-8 
Defining a Macro, 4-1 

Defining Macros (.DEFIN, .ETC., and .ENDM), 
3-14 

Defining a Symbolic Address (.DSA), 3-10 
definition, level of, 4-7, 4-8 
delimiter, 2-1, 2-15, 2-16, 2-17, 2-18 
also see Argument Delimiters 
also see Text Delimiters 
direct assignments, 2-16, 5-5 
Direct Assignment Statements, 2-4, 2-6, 2-7 
assembler operations, 2-7 
assigning a symbolic value, 2-7 
format, 2-7 
forward reference, 2-7 
disable bank mode relocation (.DBREL), 3-4 
division, 5-7 
division by zero, 2-10 
dollar sign ( $ ), 4-4 
.DSA (define symbol address), 3-10 
dummy arguments, 4-1, 4-2, 4-6 

dummy argument name, 4-3 

duplicate literals, 2-14 
DZM (example), 2-5 

E, 2-24 

EAE instructions, 2-4 

. EBREL (enable bank mode relocation), 3-1, 3-4 

8K systems, G-1 

.EJECT (listing control), 3-14 

embedded calls, 4-9, 4-10 

enable bank mode relocation (.EBREL), 3-4 

.END, 3-3, 3-6, 3-7 


.ENDM, 3-14, 4-2 

.EOT (end-of-tape statement), 3-7 

error condition, 2-19 

Error Conditions and Recovery Procedures, 5-7 
IOPS 4, 5-7 
IOPS 0-43, 5-7 
Error Detection, 5-7 
error flags, 5-7, 5-8 
equal sign ( = ), 2-7 
equivalent statements, 2-13 
.ETC, 3-14, 4-2 
Evaluation of Symbols, 2-4 

Memory Referencing Instruction Format, 2-5 

Special Symbols, 2-5 

DZM (example), 2-5 

object program storage words, 2-5 

period ( . ), 2-4 

permanent symbol table, 2-4 

user's symbol table, 2-4 

User definitions: direct assignment statements, 
2-4 

labels, 2-4 
macro names, 2-4 

variables, 2-4 

Forming: LAC (example), 2-5 

mnemonic symbols, 2-4 
symbol labels, 2-5 
executable object program, 1-2 
Expressions, 2-9 
definition of, 2-9 
division by zero, 2-10 
fractional remainders, 2-10 
list of operators, 2-10 
external (E), 5-5 
external subroutines, 1-1 
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external symbol , 1-2, 5-5 
external tronsfer vectors, 5-6 

flags, 5“4 

als© s@© Error Detection 
forward reference, 2-7 
fractional remainders, 2-10 
.FULL, .FULLP, 2-19, 3-3 
full binary mode, 1-1 

General Command Characters, 5-1 
CTRL D (ID), 5-1 
CTRL P(tP), 5-1 
CTRL U (@), 5-1 
RUBOUT (\), 5-1 
global symbols, 1-3, 2-8, 3-10 
.GLOBL (loader control), 3-9 

Hardware Requirements and Options, 1-2 
PD P-15 systems, 1-2 

IF statements, 3-13 
illegal characters, 2-3, C-2 
increment, 3-11 
index bit, 2-12 
Indexed Addressing, 2-12 
bank error, 2-12 
index bit, 2-12 
index register symbol, 2-12 
location counter, 2-12 
page 0, 2-12 
spaces, 2-12 
tabs, 2-12 

Index Instructions, B-2 

index register, 2-22, 2-23, 3-3, 4-3 


index register symbol ,2-12 
index register usage, 2-5 
indirect addressing, 2-5 
Indirect Addressing, 2-12 
asterisk, 2-12 
defer bit, 2-12 

illegal indirect addressing, 2-12 
legal indirect addressing, 2-12 
non-memory reference instruction, 2-12 
INDX5V, 4-9 

input-output transfer instructions, 2-4 
Integer Values, 2-9 
decimal integer, 2-9 
decimal radix, 2-9 
negative numbers, 2-9 
non-octal digit, 2-9 
octal integer, 2-9 
two ! s complement, 2-9, 2-10 
.IODEV (requesting l/L devices), 3-10 
IOPS 0-43, 5-7 
I/O symbol, 2-4 

Label Field, 2-15, 2-16 

delimiters and terminators, 2-15, 2 — 16 
direct assignments, 2-16 
multiply-defined symbol, 2-16 
redefinition, 2-16 
storage word, 2-14 
symbolic label, 2-15 
TAG errors (T), 2-16 
variables, 2-17 

label (or tag) field, 2-1, 2-2, 2-17 
label (or tag), 2-1, 2-4 
LAC (example), 2-5 
LAW, 2-24 
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leading zeroes, 5-5 

left arrow, 5-2 

left justified, 3-7 

level of definition, 4-7, 4-8 

line feed ( J)., 2-1 

line number, 5=4 

Linking Loader, 1-1, 1-2 

Listings, Assembly, see Assembly Listings 

Listing Control (.EJECT), 3-14 

list of operators, 2-10 

Literals, 2-13 

address field, 2-13 
address link, 2-13 
duplicate literals, 2-14 
equivalent statements, 2-13 
operation field, 2-13 
parentheses, 2-13 
literals, 3-4, 5-5, 5-6 
Loader Control (.GLOBL), 3-9 
global symbols, 3-10 
.LOC, 3-4, 3-5 
location, 5-4 

location counter, 2-11, 2-12, 2-23, 3-7 

Location Counter, Referencing, see Referencing 
the Location Counter 

.LOC pseudo op, 2-12 

Macro Body, 4-2 
.ASCII, 4-3 
.DEFIN statement, 4-2 
dummy arguments, 4-2 
dummy argument name, 4-3 
. ENDM pseudo op, 4-2 
index register usage, 4-3 
prohibited symbols, 4-3 


. SIXBT, 4-3 
Macro Calls, 4-3 

Argument Delimiters and Terminators, 4-5 

Created Symbols, 4-6 

continuation liras, 4-4 

dollar sign ($), 4-4 

octal (default radix), 4-4 

tag field, 4-4 

Macro Calls within Macro Definitions, 4-9 
embedded calls, 4-9 
macro definition, 4-1 
macro instruction, 4-1 
macro names, 2-4, 4-2 
machine instruction op codes, 2-17 
machine instructions, 2-11 
machine ops, 2-25 

Memory Referencing Instruction Format, 2-5 
index register usage, 2-5 
indirect addressing, 2-5 
op code, 2-5 
12-bits, 2-5 

memory reference instructions, 2-4 
mnemonic instruction code, 2-2 
mnemonic symbols, 2-4 
Monitor commands summary, E-1 
Monitor's Device Assignment Table, 3-10 
multiplication, 5-7 
multiplication operator, 2-18 
multiply defined symbol, 2-16 

negative numbers, 2-9 
nested conditional statements, 3-13 
nested IF statements, 3-13 
nested macros, 4-7 
Nesting of Macros, 4-7 
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.ENDM pseudo-op, 4-7 
D EF! N statement , 4-8 
level of definition, 4-7, 4-8 
NLD, 3-2 

non-memory reference instruction, 2-12 
non-oetal digit, 2-9 
Non-Minting Characters, 3-8 
angle brackets, 3-8 
.ASCII statements, 3-8 
character octal codes, 3-8 
truncating octal numbers, 3-8 
numbers (in operation and address fields), 2-24 
numbers (octal), 3-8 
Numbers, 2-8 
Expressions, 2-9 
Integer Values, 2-9 
.DEC (decimal), 2-8 
.OCT (octal), 2-8 
pseudo ops, 2-8 
radix, 2-8 
Numbers, 2-21 

current radix, 2-21 

storage word, 2-21 

number sign ), 2-6, 4-3 

object code, 5-4 
object program, 1-1 
object program storage words, 2-5 
Object Program Output, 3-1 
. ABS address error, 3-3 
absolute binary loader, 3-2, 3-3 
absolute pseudo-ops (.ABSP, .ABS), 3-2 
block heading, 3-2 
DBA instruction, 3-3 

.DBREL (disable bank mode relocation), 3-4 


. EBREL (Enable bank mode relocation), 3-4 

.END, 3-3 

.FULL, .FULLP, 3-3 

. FULL mode restrictions: . BLOCK, 3-4 

literals, 3-4 
.IOC, 3-4 

undefined symbols, 3-4 
variables, 3-4 

index register, 3-3 
NLD, 3-2 
PIP, 3-2 

relocation mode switching, 3-4 
specification of pseudo-ops, 3-2 
starting block, 3-3 
.OCT (octal), 2-8, 3-5 
octal (default radix), 4-4 
octal integer, 2-9 
octal numbers, 3-8 
.OCT pseudo op, 2-9 
op code, 2-5, 2-18 
operate instructions, 2-4 
Operating Procedures, 5-1 

operation code field , 2-2 

operation field, 2-1, 2-2, 2-4, 2-6, 2-13 
Operation Field, 2-17 
asterisk (* ), 2-17 
defer bit (bit 4), 2-17 
delimiters, 2-17 
label field, 2-17 

machine instruction op codes, 2-17 
multiplication operator, 2-18 
pseudo-op mnemonic symbols, 2-17 
S flag, 2-18 
space, 2-17 
symbol error, 2-18 
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tab, 2-17 

user defined symbols, 2-17 
operators to use with expressions, list of, 2-10 
Options, list of, 5-3 
option string format, 5-2 
output listing, 1-2 

page 0 (zero) , 2-12 

Paper Tape Input Only, 5-5 

parentheses, 2-13 

PASS1, 1-2, 2-7, 2-14, 2-25 

PASS2, 1-2, 2-7, 3-6, 3-7, 5-4 

PD P-15 systems, 1-2 

percent sign (%), 2-3 

period ( . ), 2-4, 3-1 

permanent symbol table, 2-4, 2-5, B-l 

PIP, 3-2 

Program Identification, 3-1 
.TITLE, 3-1 

program name format, 5-2 
Program Names, 5-2 
Program Relocation, 5-6 

absolute storage words, 5-6 
division, 5-7 

external transfer vectors, 5-6 
literals, 5-6 
multiplication, 5-7 
relocatable object program, 5-6 
relocatable storage words, 6-6 
relocation constant, 5-6 
undefined symbols, 5-6 
variables, 5-6 

Program Segments (.EOT), 3-7 
END, 3-7 

end of tape statement, 3-7 


Program size (.SIZE), 3-14 
Program Statements, 2-1 
address field, 2-1, 2-2 
comments, 2-3 
comments field, 2-1 
delimiters and terminators, 2-1 
fields, 2-1 
format, 2-1 
label, 2-2 

label field, 2-1, 2-2 
mnemonic instruction code, 2-2 
operation field, 2-1,2-2 
slash (/), 2-1,2-2 
statement format, 2-1 
space, 2-1 

symbolic address, 2-2 
tab, 2-1 
tag, 2-2 
tag field, 2-1 

Program Termination (.END), 3-6 
starting address, 3-6 
prohibited symbols, 4-3 
pseudo-op code, 2-18 

pseudo-operation instructions, 1-1, 2-8 
Pseudo Operations, 3-1 
period ( . ), 3-1 
pseudo-ops, 2-8, 2-25 
pseudo-op mnemonic symbols, 2-17 
Pseudo-Ops, Summary of, D-l, D-2 

question mark ( ?), 4-6 

R, 2-24 

radix, 2-8, 2-21, 3-6, 4-4 
Radix Control (.OCT and .DEC), 3-5 
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base 8 (octal), 3-5 
base 10 (decimal), 3-5 
Recursive Calls, 4-10 

conditional assembly statement, 4-10 
imbedded calls, 4-11 
nested macros, 4-11 
recursive macro calls, 3-14 
redefinition, 2-16 
Redefinition of Macros, 4-8 
.DEFIN, 4-9 
INDXSV, 4-9 

Referencing the Location Counter, 2-12 
. LOC pseudo-op, 2-12 
period (.), 2-12 
relocatable (R), 5-5 

relocatable binary obfeef program, 1-1, 1-3 
relocatable format, 1-2, 1-3 
relocatable object program, 5-6 
relocatable storage words, 5-6 
relocation constant, 5-6 
relocation mode switching, 3-4 

repeated sequence,, 4-1 

Repeating Object Coding (.REFT), 3-11 
count, 3-11 
increment, 3-11 
REFT, 3-11 

Requesting I/O Devices (.IODEV), 3-10 
DAT, 3-10 

Monitor's Device Assignment Table, 3-10 
Reserving Blocks of Storage (.BLOCK), 3-6 
PASS2, 3-6 
radix, 3-6 
RUBOUT (\), 5-1 
Running Instructions, 5-5 

Cross Reference Output, 5-5 


Paper Tape Input Only, 5-5 
leading zeroes, 5-5 

semicolons, 2-1, 2-15, 2-18, 2-20, 2-21 
SET, 2-7 

Setting Storage Locations to Zero, 2*6 
Setting the Location Counter (.LOC), 3-4 
location counter, 3-7 
PASS2, 3-7 

7-bit .ASCII, 3-7, 3-8 
character set table, A-l 
S flag, 2-18 
6-bit .ASCII, 3-7, 3-8 
character set table, A-l 
. SIXBT, 4-3 

• SIXBT Pseudo-op, 3-8, C-2 

ASCII characters, 6-bit trimmed, 3-8 
.SIZE, 3-14 

slash (/), 2-1, 2-3, 2-19, 
slash not used, 4-3 

spaces (lj), 2-12, 2-15, 2-17, 2-18, 2-20, 2-21, 
3-8, 4-3, 4-5 

Special Symbols, 2-5 

address field, 2-6 

index register usage, 2-5 

permanent symbol table, 2-5 

X, 2-5 

specification of pseudo-ops, 3-2 
standard object code, 1-2 
starting address, 3-6 
starting block, 3-3 
Statement Evaluation, 2-21 
Assembler Priority List, 2-25 
Numbers, 2-21 
Word Evaluation, 2-22 
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Word Evaluation of the Special Cases, 2-24 
Statement Fields, 2-15 
Address Field, 2-18 
Comments Field, 2-20 
Label Field, 2-15 
Operation Field, 2-17 
statement format, 2-1 
storage locations, 2-6 
storage words, 2-6, 2-11, 2-15, 2-21 
storage words, absolute, 5-6 
storage words, relocatable, 5-6 
Summary of System Macros, E-l 
symbol error, 2-18 
symbolic address, 2-2, 2-4 

also see Defining a Symbolic Address (.DSA) 
symbolic labels, 2-4, 2-5, 2-15 
symbolic tag, 4-6 
symbolic value, 2-7 
Symbols, 2-3 

Direct Assignment Statements, 2-6 
Evaluation of Symbols, 2-4 
Setting Storage Locations to Zero, 2-6 
Undefined Symbols, 2-8 
Variables, 2-6 
characters, 2-3 
symbol table, 2-5 
Symbol Table Output, 5-4 
absolute (A), 5-5 
direct assignments, 5-5 
external (E), 5-5 
literals, 5-5 
PASS2, 5-4 
relocatable (R), 5-5 
variables, 5-5 


tabs ( H ), 2-1, 2-12, 2-15, 2-17, 2-18, 2-20, 2-21, 
3-8, 4-3, 4-5 

TAG errors, 2-16 

tag field, 4-4 
also see label field 

terminator, 2-15, 2-17 

Text Delimiters, 3-8 

angle bracket (<), 3-8 

apostrophe ('), 3-8 

carriage return ( J ), 3-8 

spaces ( ), 3-8 

tabs ( H ), 3-8 

Text Handling (.ASCII and .SIXBT), 3-7 
.ASCII Pseudo-op, 3-7 
Non-Printing Characters, 3-8 
. SIXBT pseudo-op, 3-8 
Text Delimiters, 3-10 
Text Statement Format, 3-8 
left justified, 3-7 
Text Statement Format, 3-8 
Three-pass operation, 1-2 
.TITLE, 3-1, 3-2 
truncating octal numbers, 3-8 

12-bits, 2-5 

Two-pass operation, 1-2 
two's complement, 2-9, 2-10 

Undefined Symbols, 2-8 
global symbols, 2-8 
undefined symbols, 3-4, 5-6 
user defined symbols, 2-17 
user definitions, 2-4 

direct assignment statements, 2-4 
labels, 2-4 
macro names, 2-4 
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period ( . ), 2-4 
variables, 2-4 

user's symbol table, 2-4 

variable locations, 5-4 

Variables, 2-5, 2-6 
address field, 2-6 
number sign (^ ), 2-6 
operation field, 2-6 
storage word, 2-6 
symbol table, 2-6 

variables, 2-4, 2-17, 3-4, 5-5, 5-6 

Word Evaluation, 2-22 
bank bits, 2-23 
bank mode, 2-23 
index register, 2-22, 2-23 
location counter, 2-23 
word value, 2-22 

Word Evaluation of the Special Cases, 2-24 
AAC, AAS, AXR, AXS, 2-24 
E, 2-24 
LAW, 2-24 
R, 2-24 
numbers, 2-24 

X (index register usage), 2-5 

zero, division by, 2-10 

zeroes, leading, 5-5 



HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, software problems, and documenta¬ 
tion corrections are published by Software Information Service in the following newsletters. 


Digital Software News for the PDP-8 Family 
Digital Software News for the PDP-9/15 Family 
PDP-6/PDP-10 Software Bulletin 


These newsletters contain information applicable to software available from Digital’s Program Library. 


Please complete the card below to place your name on the newsletter mailing list. 


Questions or problems concerning DEC Software should be reported to the Software Specialist at your nearest DEC 
regional or district sales office. In cases where no Software Specialist is available, please send a Software Trouble 
Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms, which are available without charge from the Program Library, should be fully filled out and accompa¬ 
nied by teletype output as well as listings or tapes of the user program to facilitate a complete investigation. An 
answer will be sent to the individual and appropriate topics of general interest will be printed in the newsletter. 


New and revised software and manuals. Software Trouble Report forms, and cumulative Software Manual Updates 
are available from the Program Library. When ordering, include the document number and a brief description of 
the program or manual requested. Revisions of programs and documents will be announced in the newsletters and 
a price list will be included twice yearly. Direct all inquiries and requests to: 

Program Library 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

Digital Equipment Computer Users Society (DECUS) maintains a user Library and publishes a catalog of programs 
as well as the DECUSCOPE magazine for its members and non-members who request it. For further information 

please write to: - 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


Send Digital’s software newsletters to: 

Name 

Company Name 
Address _ 


My computer is a 

PDP-8/1 □ 

PDP-8/L □ 

(zip code) 


LINC-8 □ 

PDP-9 □ 

PDP-12 □ 
PDP-15 □ 

Please specify 

My system serial number is 

PDP-10 □ 

OTHER □_ 
(if known) 
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READER’S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness of its 
publications. To do this effectively we need user feedback - your critical evaluation of this manual. 

Please comment on this manual’s completeness, accuracy, organization, usability, and readability. 


Did you find errors in this manual? 


How can this manual be improved? 


DEC also strives to keep its customers informed of current DEC software and publications. Thus, the following period¬ 
ically distributed publications are available upon request. Please check the appropriate boxes for a current issue of the 
publication(s) desired. 

n Software Manual Update, a quarterly collection of revisions to current software manuals. 


Q User’s Bookshelf, a bibliography of current software manuals. 


0 Program Library Price List, a list of currently available software programs and manuals. 
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Name ____ Organization _____________________ 
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